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Introduction 




/ava is good stuff. I've been using it for years. I like Java because it's very 
orderly. Almost everything follows simple rules. The rules can seem intim- 
idating at times, but this book is here to help you figure them out. So, if you 
want to use Java and want an alternative to the traditional techie, soft-cover 
book, sit down, relax, and start reading Java 2 For Dummies, 2nd Edition. 



I wish I could say, "Open to a random page of this book and start writing Java 
code. Just fill in the blanks and don't look back." In a sense, this is true. You 
can't break anything by writing Java code, so you're always free to experiment. 

But let me be honest. If you don't understand the bigger picture, writing a 
program is difficult. That's true with any computer programming language — 
not just Java. If you're typing code without knowing what it's about, and the 
code doesn't do exactly what you want it to do, you're just plain stuck. 

So, in this book, I divide Java programming into manageable chunks. Each 
chunk is (more or less) a chapter. You can jump in anywhere you want — 
Chapter 5, Chapter 10, or wherever. You can even start by poking around in 
the middle of a chapter. I've tried to make the examples interesting without 
making one chapter depend on another. When I use an important idea from 
another chapter, I include a note to help you find your way around. 

In general, my advice is as follows: 

v* If you already know something, don't bother reading about it. 

If you're curious, don't be afraid to skip ahead. You can always sneak a 
peek at an earlier chapter if you really need to do so. 



How to Use This Book 



Contentions Used in This Book 



Almost every technical book starts with a little typeface legend, and Java 2 
For Dummies, 2nd Edition, is no exception. What follows is a brief explanation 
of the typefaces used in this book: 
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*>* New terms are set in italics. 



■-^ tr* If you need to type something that's mixed in with the regular text, the 

1 1^ i^rV^ aCterS t ^' 36 a ^ ) ' 3ear m ' 30 ' c '' ^ or exam P' e: "Type MyNewProject 



le text field." 

You also see this computerese font. I use computerese for Java code, 
filenames, Web page addresses (URLs), on-screen messages, and other 
such things. Also, if something you need to type is really long, it appears 
in computerese font on its own line (or lines). 

You need to change certain things when you type them on your own 
computer keyboard. For instance, I may ask you to type 

public class Anyname 

which means that you type public class and then some name that you 
make up on your own. Words that you need to replace with your own 
words are set in i ta 7 i ci zed computerese. 



What \lou bort't HaVe to Read 

Pick the first chapter or section that has material you don't already know and 
start reading there. Of course, you may hate making decisions as much as I 
do. If so, here are some guidelines that you can follow: 

If you already know what kind of an animal Java is and know that you 
want to use Java, skip Chapter 1 and go straight to Chapter 2. Believe 
me, I won't mind. 

If you already know how to get a Java program running, skip Chapter 2 
and start with Chapter 3. 

V If you write programs for a living but use any language other than C or 
C++, start with Chapter 2 or 3. When you reach Chapters 5 and 6, you'll 
probably find them to be easy reading. When you get to Chapter 7, it'll 
be time to dive in. 

V If you write C (not C++) programs for a living, start with Chapters 3 and 4 
but just skim Chapters 5 and 6. 

V If you write C++ programs for a living, glance at Chapter 3, skim Chapters 
4 through 6, and start reading seriously in Chapter 7. (Java is a bit differ- 
ent from C++ in the way it handles classes and objects.) 

If you write Java programs for a living, come to my house and help me 
write Java 2 For Dummies, 3rd Edition. 

If you want to skip the sidebars and the Technical Stuff icons, please do. In 
fact, if you want to skip anything at all, feel free. 
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ok, I make a few assumptions about you, the reader. If one of these 
assumptions is incorrect, you're probably okay. If all these assumptions are 
incorrect . . . well, buy the book anyway. 

*>* I assume that you have access to a computer. Here's the good news: 
You can run the code in this book on almost any computer. The only 
computers that you can't use to run this code are ancient things that are 
more than six years old (give or take a few years). 

f I assume that you can navigate through your computer's common 
menus and dialog boxes. You don't have to be a Windows, Unix, or 
Macintosh power user, but you should be able to start a program, find a 
file, put a file into a certain directory . . . that sort of thing. Most of the 
time, when you practice the stuff in this book, you're typing code on 
your keyboard, not pointing and clicking your mouse. 

On those rare occasions when you need to drag and drop, cut and paste, 
or plug and play, I guide you carefully through the steps. But your com- 
puter may be configured in any of several billion ways, and my instruc- 
tions may not quite fit your special situation. So, when you reach one of 
these platform-specific tasks, try following the steps in this book. If the 
steps don't quite fit, consult a book with instructions tailored to your 
system. 

V I assume that you can think logically. That's all there is to programming 
in Java — thinking logically. If you can think logically, you've got it made. 
If you don't believe that you can think logically, read on. You may be 
pleasantly surprised. 

I make very few assumptions about your computer programming 
experience (or your lack of such experience). In writing this book, I've 
tried to do the impossible. I've tried to make the book interesting for 
experienced programmers, yet accessible to people with little or no pro- 
gramming experience. This means that I don't assume any particular 
programming background on your part. If you've never created a loop or 
indexed an array, that's okay. 

On the other hand, if you've done these things (maybe in Visual Basic, 
COBOL, or C++), you'll discover some interesting plot twists in Java. The 
developers of Java took the best ideas in object-oriented programming, 
streamlined them, reworked them, and reorganized them into a sleek, 
powerful way of thinking about problems. You'll find many new, thought- 
provoking features in Java. As you find out about these features, many of 
them will seem very natural to you. One way or another, you'll feel good 
about using Java. 
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is divided into subsections, which are grouped into sections, 
which come together to make chapters, which are lumped finally into six 
parts. (When you write a book, you get to know your book's structure pretty 
well. After months of writing, you find yourself dreaming in sections and 
chapters when you go to bed at night.) The parts of the book are listed here. 



Part 1: Getting Started 

This part is your complete executive briefing on Java. It includes a "What is 
Java?" chapter and a complete set of instructions on installing and running 
Java. It also has a jump-start chapter — Chapter 3. In this chapter, you visit 
the major technical ideas and dissect a simple program. 



Part 11: Writing \lour Ottfn Jai/a Programs 

Chapters 4 through 6 cover the basic building blocks. These chapters 
describe the things that you need to know so you can get your computer 
humming along. 

If you've written programs in Visual Basic, C++, or any another language, 
some of the material in Part II may be familiar to you. If so, you can skip some 
sections or read this stuff quickly. But don't read too quickly. Java is a little 
different from some other programming languages, especially in the things 
that I describe in Chapter 4. 



Part 111: Working With the Big Picture: 
Object-Oriented Programming 

Part III has some of my favorite chapters. This part covers the all-important 
topic of object-oriented programming. In these chapters, you find out how to 
map solutions to big problems. (Sure, the examples in these chapters aren't 
big, but the examples involve big ideas.) In bite-worthy increments, you dis- 
cover how to design classes, reuse existing classes, and construct objects. 

Have you read any of those books that explain object-oriented programming 
in vague, general terms? I'm very proud to say that Java 2 For Dummies, 2nd 
Edition, isn't like that. In this book, I illustrate each concept with a simple-yet- 
concrete program example. 
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Part \V: SaWy JaVa Techniques 



tasted some Java and want more, you can find what you need in this 
e book. This part's chapters are devoted to details — the things that 
you don't see when you first glance at the material. So, after you read the ear- 
lier parts and write some programs on your own, you can dive in a little 
deeper by reading Part IV. 



Part V: The Part of Tens 

The Part of Tens is a little Java candy store. In the Part of Tens, you can find 
lists — lists of tips for avoiding mistakes, resources, and all kinds of interesting 
goodies. 



Part Vh Appendixes 

The book has two appendixes. One appendix tells you all about this book's 
CD-ROM (what's on the CD, how to use the CD, how to make the CD look like 
a UFO at night, and so on). The other appendix summarizes some important 
rules for writing Java programs. To find out which parts of your code spill 
over automatically into other peoples' code, read the second appendix. 

Bonus Chapters on the CD-ROM! 

You've read the Java 2 For Dummies book, seen the Java 2 For Dummies 
movie, worn the Java 2 For Dummies T-shirt, and eaten the Java 2 For 
Dummies candy. What more is there to do? 

That's easy. Just pop in the book's CD-ROM and you can find four additional 
chapters: 

In Chapter 15, you combine several smaller programs to create a bigger 
program. As part of that process, you find out which parts of one pro- 
gram are of use to any other program. You get an expanded description 
of the material in Appendix B. 

V In Chapter 16, you handle button clicks, keystrokes, and other such 
things. You find out about one additional Java language feature (some- 
thing like a Java class) called an interface. 
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**" In Chapter 17, you deal with Java applets. You put applets on Web 
pages, draw things, and make things move. You create a small game that 



ors to your site can play. 



hapter 18, you see an example of Java database handling. The exam- 
ple takes you from start to finish — from establishing a connection and 
creating a table to adding rows and making queries. 

Note: For you Web fanatics out there, you can also read the bonus chapters 

on the Web at www . dummi es . com/go/ j ava2_f d. 



Icons Used in This Book 

If you could watch me write this book, you'd see me sitting at my computer, 
talking to myself. I say each sentence in my head. Most of the sentences I 
mutter several times. When I have an extra thought, a side comment, or 
something that doesn't belong in the regular stream, I twist my head a little 
bit. That way, whoever's listening to me (usually nobody) knows that I'm off 
on a momentary tangent. 

Of course, in print, you can't see me twisting my head. I need some other way 
of setting a side thought in a corner by itself. I do it with icons. When you see 
a Tip icon or a Remember icon, you know that I'm taking a quick detour. 



Here's a list of icons that I use in this book. 




A tip is an extra piece of information — something helpful that the other 
books may forget to tell you. 



Everyone makes mistakes. Heaven knows that I've made a few in my time. 
Anyway, when I think people are especially prone to make a mistake, I mark it 
with a Warning icon. 



Question: What's stronger than a Tip, but not as strong as a Warning? 
Answer: A Remember icon. 




"If you don't remember what such-and-such means, see Wa/j-Wa/j-Waft," or 
more information, read blahbity-blah-blah." 



For 
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This icon calls attention to useful material that you can find online. (You 
don't have to wait long to see one of these icons. I use one at the end of this 
^tion!) 



ate 1 



I use this icon to point out useful stuff that's on the CD (obviously). 




Occasionally I run across a technical tidbit. The tidbit may help you under- 
stand what the people behind the scenes (the people who developed Java) 
were thinking. You don't have to read it, but you may find it useful. You may 
also find the tidbit helpful if you plan to read other (more geeky) books about 
Java. 



Where to Go from Here 

If you've gotten this far, you're ready to start reading about Java. Think of me 
(the author) as your guide, your host, your personal assistant. I do everything 
I can to keep things interesting and, most importantly, help you understand. 

If you like what you read, send me a note. My e-mail address, which I created 
just for comments and questions about this book, is Java2ForDummi es@ 
BurdBrain.com. And don't forget — for the latest updates, visit one of this 
book's support Web sites. The support sites' addresses are www .BurdBrain. 
com and www . dummi es . com/go/ j a va2_fd. 
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In this part . . . 




ecome acquainted with Java. Find out what Java is 
all about, and whether you do (or don't) want to use 



Java. If you've heard things about Java and aren't sure 
what they mean, the material in this part can help you. If 
you're staring at your computer, wondering how you're 
going to get a Java program running, this part has the 
information that you need. Maybe you've told people that 
you're a Java expert, and now you need to do some seri- 
ous bluffing. If so, this part of the book is your crash 
course in Java. (Of course, if the word bluffing describes 
you accurately, you may also want to pick up a copy of 
Ethics For Dummies.') 
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Chapter 1 



All about Java 



In This Chapter 

What Java is 

Where Java came from 

Why Java is so cool 

How to orient yourself to object-oriented programming 



Way what you want about computers. As far as I'm concerned, computers 
w are good for just two simple reasons: 

i>* When computers do work, they feel no resistance, no stress, no bore- 
dom, and no fatigue. Computers are our electronic slaves. I have my 
computer working 24/7 doing calculations for SETI@home — the search 
for extraterrestrial intelligence. Do I feel sorry for my computer because 
it's working so hard? Does the computer complain? Will the computer 
report me to the National Labor Relations Board? No. 

I can make demands, give the computer its orders, and crack the whip. 
Do I (or should I) feel the least bit guilty? Not at all. 

f" Computers move ideas, not paper. Not long ago, when you wanted to 
send a message to someone, you hired a messenger. The messenger got 
on his or her horse and delivered your message personally. The message 
was on paper, parchment, a clay tablet, or whatever physical medium 
was available at the time. 

This whole process seems wasteful now, but that's only because you and 
I are sitting comfortably at the dawn of the electronic age. The thing is 
that messages are ideas. Physical things like ink, paper, and horses have 
little or nothing to do with real ideas. These physical things are just tem- 
porary carriers for ideas (temporary because people used them to carry 
ideas for several centuries). But, in truth, the ideas themselves are 
paperless, horseless, and messengerless. 

So the neat thing about computers is that they carry ideas efficiently. 
They carry nothing but the ideas, a couple of photons, and a little elec- 
trical power. They do this with no muss, no fuss, and no extra physical 
baggage. 



• • • • • 
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When you start dealing efficiently with ideas, something very nice happens. 
Suddenly, all the overhead is gone. Instead of pushing paper and trees, you're 
umbers and concepts. Without the overhead, you can do things 
ter and do things that are far more complex than ever before. 



What \!ou Can Do vOith Jatfa 

It would be so nice if all this complexity was free, but unfortunately, it isn't. 
Someone has to think hard and decide exactly what the computer will be 
asked to do. After that thinking is done, someone has to write a set of instruc- 
tions for the computer to follow. 

Given the current state of affairs, you can't write these instructions in English 
or any other language that people speak. Science fiction is filled with stories 
about people who say simple things to robots and get back disastrous, unex- 
pected results. English and other such languages are unsuitable for communi- 
cation with computers for several reasons: 

An English sentence can be misinterpreted. "Chew one tablet three 
times a day until finished." 

V It's difficult to weave a very complicated command in English. "Join 
flange A to protuberance B, making sure to connect only the outermost 
lip of flange A to the larger end of the protuberance B, while joining the 
middle and inner lips of flange A to grommet C." 

i>* An English sentence has lots of extra baggage. "Sentence has unneeded 
words." 

i>* English is difficult to interpret. "As part of this Publishing Agreement 
between John Wiley & Sons, Inc. ('Wiley') and the Author ('Barry Burd'), 
Wiley shall pay the sum of one-thousand-two-hundred-fifty-seven dollars 
and sixty-three cents ($1,257.63) to the Author for partial submittal of 
Java 2 For Dummies, 2nd Edition ('the Work')." 

To tell a computer what to do, you have to speak a special language and write 
terse, unambiguous instructions in that language. A special language of this 
kind is called a computer programming language. A set of instructions, written 
in such a language, is called a program. When they're looked at as a big blob, 
these instructions are called software or code. Here's what code looks like 
when it's written in Java: 

import static ja va . 1 ang . System . out ; 

class PayBarry { 

public static void main(String args[]) I 
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double checkAmount = 1257.63; 
out . pri nt ( " Pay to the order of 
out . pri nt( "Dr . Barry Burd "); 
out . pri nt ( " $ " ) ; 
out.println (checkAmount ) ; 



Why \lou Should Use JaVa 



It's time to celebrate! You've just picked up a copy of Java 2 For Dummies, 
2nd Edition, and you're reading Chapter 1. At this rate, you'll be an expert 
Java programmer in no time at all, so rejoice in your eventual success by 
throwing a big party. 



To prepare for the party, I'll bake a cake. I'm lazy, so I'll use a ready-to-bake 
cake mix. Let me see . . . add water to the mix, and then add butter and eggs . . . 
Hey, wait! I just looked at the list of ingredients. What's MSG? And what about 
propylene glycol? That's used in antifreeze, isn't it? 

I'll change plans and make the cake from scratch. Sure, it's a little harder. But 
that way, I get exactly what I want. 

Computer programs work the same way. You can use somebody else's pro- 
gram or write your own. If you use somebody else's program, you use what- 
ever you get. When you write your own program, you can tailor the program 
especially for your needs. 

Writing computer code is a big, worldwide industry. Companies do it, free- 
lance professionals do it, hobbyists do it, all kinds of people do it. A typical 
big company has teams, departments, and divisions that write programs for 
the company. But you can write programs for yourself or someone else, for a 
living or for fun. In a recent estimate, the number of lines of code written 
each day by programmers in the United States alone exceeds the number of 
methane molecules on the planet Jupiter.* Take almost anything that can be 
done with a computer. With the right amount of time, you can write your own 
program to do it. (Of course, the "right amount of time" may be very long, but 
that's not the point. Many interesting and useful programs can be written in 
hours or even minutes.) 



* / made up this statistic all by myself. 
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jrief history of modern computer programming: 

f 1954-1957: FORTRAN is developed. 

FORTRAN was the first modern computer programming language. For 
scientific programming, FORTRAN is a real racehorse. Year after year, 
FORTRAN is a leading language among computer programmers through- 
out the world. A well-known computer scientist, Tony Hoare, once said, 
"I don't know what the language of the year 2000 will look like, but I 
know it will be called FORTRAN." 

W 1959: COBOL is created. 

The letter B in COBOL stands for Business, and business is just what 
COBOL is all about. The language's primary feature is the processing of 
one record after another, one customer after another, or one employee 
after another. 

Within a few years after its initial development, COBOL became the most 
widely used language for business data processing. Even today, COBOL 
represents a large part of the computer programming industry. 

1972: Dennis Ritchie at AT&T Bell Labs develops the C programming 
language. 

The look and feel that you see in this book's examples come from the C 
programming language. Code written in C uses curly braces, i f state- 
ments, for statements, and so on. 

In terms of power, you can use C to solve the same problems that you 
can solve by using FORTRAN, Java, or any other modern programming 
language. (You can write a scientific calculator program in COBOL, but 
doing that sort of thing would feel really strange.) The difference 
between one programming language and another isn't power. The differ- 
ence is ease and appropriateness of use. That's where the Java language 
excels. 

1986: Bjarne Stroustrup (again at AT&T Bell Labs) develops C++. 

Unlike its C language ancestor, the language C++ supports object- 
oriented programming. This represents a huge step forward. 

May 23, 1995: Sun Microsystems releases its first official version of the 
Java programming language. 

Java improves upon the concepts in C++. Unlike C++, Java is streamlined 
for use on the World Wide Web. Java's "Write Once, Run Anywhere" phi- 
losophy makes the language ideal for distributing code across the 
Internet. 
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In addition, Java is a great general-purpose programming language. With 
Java, you can write windowed applications, build and explore databases, 
k trol handheld devices, and more. Within five short years, the Java 
ramming language had 2.5 million developers worldwide. (I know. I 
have a commemorative T-shirt to prove it.) 

i>* November 2000: The College Board announces that, starting in the 
year 2003, the Computer Science Advanced Placement exams will be 
based on Java. 

Wanna know what that snot-nosed kid living down the street is going to 
be learning in high school next year? You guessed it — Java. 

March 2003: SkillMarket (ms h i 1 ton j . com/ sm) reports that the demand 
for Java programmers tops the demand for C++ programmers by 42 
percent. 

And there's more! The demand for Java programmers beats the com- 
bined demand for C++ and C# programmers by 10 percent. Java pro- 
grammers are more employable than VB (Visual Basic) programmers by 
a whopping 111 percent. 



Object-Oriented Programming ( OOP) 

It's three in the morning. I'm dreaming about the history course that I failed 
in high school. The teacher is yelling at me, "You have two days to study for 
the final exam, but you won't remember to study. You'll forget and feel guilty, 
guilty, guilty." 

Suddenly, the phone rings. I'm awakened abruptly from my deep sleep. (Sure, 
I disliked dreaming about the history course, but I like being awakened even 
less.) At first, I drop the telephone on the floor. After fumbling to pick it up, I 
issue a grumpy, "Hello, who's this?" A voice answers, "I'm a reporter from The 
New York Times. I'm writing an article about Java and I need to know all about 
the programming language in five words or less. Can you explain it?" 

My mind is too hazy. I can't think. So I say anything that comes to my mind, 
and then go back to sleep. 

Come morning, I hardly remember the conversation with the reporter. In fact, 
I don't remember how I answered the question. Did I tell the reporter where 
he could put his article about Java? 

I put on my robe and rush to the front of my house's driveway. As I pick up 
the morning paper, I glance at the front page and see the two-inch headline: 

Burd Calls Java "A Great Object-Oriented Language" 
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ject-oriented. What does that mean? Unlike languages such as FOR- 
ich focus on giving the computer imperative "Do this/Do that" com- 
mands, object-oriented languages focus on data. Of course, object-oriented 
programs still tell the computer what to do. You start, however, by organizing 
the data, and the commands come later. 

Object-oriented languages are better than "Do this/Do that" languages 
because they organize data in a way that lets people do all kinds of things 
with it. To modify the data, you can build on what you already have, rather 
than scrap everything you've done and start over each time you need to do 
something new. Although computer programmers are generally smart people, 
they took awhile to figure this out. For the full history lesson, see the sidebar 
"The winding road from FORTRAN to Java" (but I won't make you feel guilty if 
you don't read it). 



The winding road from FORTRAN to Java 



Back in the mid-1950s, a team of people created 
a programming language named FORTRAN. It 
was a good language, but it was based on the 
idea that you should issue direct, imperative 
commands to the computer. "Do this, computer. 
Then do that, computer." (Of course, the com- 
mands in a real FORTRAN program were much 
more precise than "Do this" or "Do that") 

In the years that followed, teams developed 
many new computer languages, and many of 
the languages copied the FORTRAN "Do this/Do 
that" model. One of the more popular "Do this/Do 
that" languages went by the one-letter name C. 
Of course, the "Do this/Do that" camp had some 
renegades. In languages named SIMULA and 
Smalltalk, programmers moved the imperative 
"Do this" commands into the background and 
concentrated on descriptions of data. In these 
languages, you didn't come right out and say, 
"Print a list of delinquent accounts." Instead, 
you began by saying, "This is what it means to 
be an account. An account has a name and a 
balance." Then you said, "This is how you ask 



an account whether it's delinquent." Suddenly, 
the data became king. An account was a thing 
that had a name, a balance, and a way of telling 
you whether it was delinquent. 

Languages thatfocus first on the data are called 
object-oriented programming languages. These 
object-oriented languages make excellent pro- 
gramming tools. Here's why: 

v 0 Thinking first about the data makes you a 
good computer programmer. 

v 0 You can extend and reuse the descriptions 
of data over and over again. When you try 
to teach old FORTRAN programs newtricks, 
however, the old programs show how brittle 
they are. They break. 

In the 1970s, object-oriented languages like 
SIMULA and Smalltalk became buried in the 
computer hobbyist magazine articles. In the 
meantime, languages based on the old FOR- 
TRAN model were multiplying like rabbits. 
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_So in 1986, a fellow named Bjarne Stroustrup 
Hfli|a*ra*«k named C++. The C++ lan- 
j^cjn|eV^^popular because it mixed 
the old C language terminology with the 
improved object-oriented structure. Many com- 
panies turned their backs on the old FORTRAN/C 
programming style and adopted C++ as their 
standard. 

But C++ had a flaw. Using C++, you could 
bypass all the object-oriented features and 
write a program by using the old FORTRAN/C 
programming style. When you started writing a 
C++ accounting program, you could take either 
fork in the road: 

You could start by issuing direct "Do this" 
commands to the computer, saying the 
mathematical equivalent of "Print a list of 
delinquent accounts, and make it snappy." 

You could take the object-oriented approach 
and begin by describing what it means to be 
an account. 



Some people said that C++ offered the best of 
both worlds, but others argued that the first 
world (the world of FORTRAN and C) shouldn't 
be part of modern programming. If you gave a 
programmer an opportunityto write code either 
way,the programmerwould too often choose to 
write code the wrong way. 

So in 1995, James Gosling of Sun Microsystems 
created the language named Java. In creating 
Java, Gosling borrowed the look and feel of C++. 
But Gosling took most of the old "Do this/Do 
that" features of C++ and threw them in the 
trash. Then he added features that made the 
development of objects smoother and easier. All 
in all. Gosling created a language whose object- 
oriented philosophy is pure and clean. When 
you program in Java, you have no choice butto 
work with objects. That's the way it should be. 



Objects and their classes 

In an object-oriented language, you use objects and classes to organize your 
data. 

Imagine that you're writing a computer program to keep track of the houses in 
a new real-estate development. The development (still under construction) is 
a condominium. The houses differ only slightly from one another. Each house 
has a distinctive siding color, an indoor paint color, a kitchen cabinet style, and 
so on. In your object-oriented computer program, each house is an object. 

But objects aren't the whole story. Although the houses differ slightly from one 
another, all the houses share the same list of characteristics. For instance, each 
house has a characteristic known as siding color. Each house has another 
characteristic known as kitchen cabinet style. In your object-oriented pro- 
gram, you need a master list containing all the characteristics that a house 
object can possess. This master list of characteristics is called a class. 

So there you have it. Object-oriented programming is misnamed. It should 
really be called "programming with classes and objects." 
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Now notice that I put the word classes first. How dare I do this! Well, maybe 
I'm not so crazy. Think again about a housing development that's under con- 
ty^f. Somewhere on the lot, in a rickety trailer parked on bare dirt, is a 
t of characteristics known as a blueprint. An architect's blueprint is 
like an object-oriented programmer's class. A blueprint is a list of characteris- 
tics that each house will have. The blueprint says, "siding." The actual house 
object has gray siding. The blueprint says, "kitchen cabinet." The actual 
house object has Louis XIV kitchen cabinets. 

The analogy doesn't end with lists of characteristics. Another important par- 
allel exists between blueprints and classes. A year after you create the blue- 
print, you use it to build ten houses. It's the same with classes and objects. 
First, the programmer writes code to describe a class. Then when the pro- 
gram runs, the computer creates objects from the (blueprint) class. 

So that's the real relationship between classes and objects. The programmer 
defines a class, and from the class definition, the computer makes individual 
objects. 



What's so good about an 
object-oriented language) 

Based on the previous section's story about home building, imagine that you 
have already written a computer program to keep track of the building 
instructions for houses in a new development. Then, the big boss decides on 
a modified plan — a plan in which half the houses have three bedrooms, and 
the other half have four. 



If you use the old FORTRAN/C style of computer programming, your instruc- 
tions look like this: 



Dig 


a ditch for the basement. 






Lay 


concrete around the sides of 


the 


di tch . 


Put 


two-by-fours along the sides 


for 


the basement's frame. 



This would be like an architect creating a long list of instructions instead of a 
blueprint. To modify the plan, you would have to sort through the list to find 
the instructions for building bedrooms. To make things worse, the instructions 
could be scattered among pages 234, 394-410, 739, 10, and 2. If the builder had 
to decipher other peoples' complicated instructions, the task would be ten 
times harder. 

Starting with a class, however, is like starting with a blueprint. If someone 
decides to have both three- and four-bedroom houses, you can start with a 
blueprint called the house blueprint that has a ground floor and a second 
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floor, but has no indoor walls drawn on the second floor. Then, you make two 
more second-floor blueprints — one for the three-bedroom house and 

or the four-bedroom house. (You name these new blueprints the 
oom house blueprint and the four-bedroom house blueprint.) 



Your builder colleagues are amazed with your sense of logic and organiza- 
tion, but they have concerns. They pose a question. "You called one of the 
blueprints the 'three-bedroom house' blueprint. How can you do this if it's a 
blueprint for a second floor, and not for a whole house?" 

You smile knowingly and answer, "The three-bedroom house blueprint can 
say, 'For info about the lower floors, see the original house blueprint.' That 
way, the three-bedroom house blueprint describes a whole house. The four- 
bedroom house blueprint can say the same thing. With this setup, we can 
take advantage of all the work we already did to create the original house 
blueprint and save lots of money." 

In the language of object-oriented programming, the three- and four-bedroom 
house classes are inheriting the features of the original house class. You can 
also say that the three- and four-bedroom house classes are extending the 
original house class. (See Figure 1-1.) 

The original house class is called the superclass of the three- and four-bedroom 
house classes. In that vein, the three- and four-bedroom house classes are sub- 
classes of the original house class. Put another way, the original house class 
is called the parent class of three- and four-bedroom house classes. The three- 
and four-bedroom house classes are child classes of the original house class. 
(See Figure 1-1.) 



Figure 1-1: 

Terminology 
in object- 
oriented 
program- 
ming. 



Superclass Parent 



house class 



The house class is 
th esuperclass of the three-bedroom house class, 
Xheparent class of the three-bedroom house class, 
thesuperclassoX the four-bedroom house class, 
theparent class of the four-bedroom house class. 




The three-bedroom house class 
exfenrfsthe house class, 
Inherits the features of the house class, 
is a subclass of the house class, 
is a child class of the house class. 



The four-bedroom house class 
exfentfsthe house class, 
inheritsthe features of the house class, 
is a subclass of the house class, 
is a child class of the house class. 
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Needless to say, your home-builder colleagues are jealous. A crowd of home- 
builders is mobbing around you to hear about your great ideas. So, at that 

you drop one more bombshell: "By creating a class with subclasses, 
use the blueprint in the future. If someone comes along and wants a 
five-bedroom house, we can extend our original house blueprint by making a 
five-bedroom house blueprint. We'll never have to spend money for an origi- 
nal house blueprint again." 



"But," says a colleague in the back row, "what happens if someone wants a 
different first-floor design? Do we trash the original house blueprint or start 
scribbling all over the original blueprint? That'll cost big bucks, won't it?" 

In a confident tone, you reply, "We don't have to mess with the original house 
blueprint. If someone wants a Jacuzzi in his living room, we can make a new, 
small blueprint describing only the new living room and call this the Jacuzzi- 
in-living-room house blueprint. Then, this new blueprint can refer to the origi- 
nal house blueprint for info on the rest of the house (the part that's not in the 
living room)." In the language of object-oriented programming, the Jacuzzi-in- 
living-room house blueprint still extends the original house blueprint. The 
Jacuzzi blueprint is still a subclass of the original house blueprint. In fact, all 
the terminology about superclass, parent class, and child class still applies. 
The only thing that's new is that the Jacuzzi blueprint overrides the living 
room features in the original house blueprint. 

In the days before object-oriented languages, the programming world experi- 
enced a crisis in software development. Programmers wrote code, then dis- 
covered new needs, and then had to trash their code and start from scratch. 
This happened over and over again because the code that the programmers 
were writing couldn't be reused. Object-oriented programming changed all 
this for the better (and, as Burd said, Java is "A Great Object-Oriented 
Language"). 



Refining your understanding 
of classes and objects 

When you program in Java, you work constantly with classes and objects. 
These two ideas are really important. That's why, in this chapter, I hit you 
over the head with one analogy after another about classes and objects. 

Close your eyes for a minute and think about what it means for something to 
be a chair. . . . 

A chair has a seat, a back, and legs. Each seat has a shape, a color, a degree of 
softness, and so on. These are the properties that a chair possesses. What I 
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describe is chairness — the notion of something being a chair. In object- 
oriented terminology, I'm describing the chair class. 
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over the edge of this book's margin and take a minute to look 
around your room. (If you're not sitting in a room right now, fake it.) 

Several chairs are in the room, and each chair is an object. Each of these 
objects is an example of that ethereal thing called the Chair class. So that's 
how it works — the class is the idea of chairness, and each individual chair is 
an object. 

A class isn't quite a collection of things. Instead, a class is the idea behind a 
certain kind of thing. When I talk about the class of chairs in your room, I'm 
talking about the fact that each chair has legs, a seat, a color, and so on. The 
colors may be different for different chairs in the room, but that doesn't 
matter. When you talk about a class of things, you're focusing on the proper- 
ties that each of the things possesses. 

It makes sense to think of an object as being a concrete instance of a class. In 
fact, the official terminology is consistent with this thinking. If you write a 
Java program in which you define a Chai r class, each actual chair (the chair 
that you're sitting on, the empty chair right next to you, and so on) is called 
an instance of the Chair class. 



Here's another way to think about a class. Imagine a table displaying all three 
of your bank accounts. (See Table 1-1.) 



Table 1-1 


A Table of Accounts 




Account Number 


Type 


Balance 


16-13154-22864-7 


Checking 


174.87 


1011 1234 2122 0000 


Credit 


-471.03 


16-17238-13344-7 


Savings 


247.38 



Think of the table's column headings as a class, and think of each row of the 
table as an object. The table's column headings describe the Account class. 

According to the table's column headings, each account has an account 
number, a type, and a balance. Rephrased in the terminology of object- 
oriented programming, each object in the Account class (that is, each 
instance of the Account class) has an account number, a type, and a 
balance. So, the bottom row of the table is an object with account number 
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16-17238-13344-7. This same object has type Savings and a balance of 247.38. 
If you opened a new account, you would have another object, and the table 
,ow an additional row. The new object would be an instance of the 
ount class. 



What's Next) 

This chapter is filled with general descriptions of things. A general descrip- 
tion is good when you're just getting started, but you don't really understand 
things until you get to know some specifics. That's why the next several 
chapters deal with specifics. 

So please, turn the page. The next chapter can't wait for you to read it. 




Chapter 2 

Dro P%aSg Cannedlava Programs 

In This Chapter 

Setting up your computer to run Java 
Running text-based programs 
Running window-based programs 
Running Java applets 



7 he best way to get to know Java is to do Java. When you're doing Java, 
you're writing, testing, and running your own Java programs. This chap- 
ter gets you ready to do Java by having you run and test programs. Instead of 
writing your own programs, however, you get to run programs I've already 
written for you — nice guy that I am. 

boWnloadinq and Installing the Ja</a 
Softu/are development Kit (SDK) 

First you need some Java development software. You can choose from several 
products. In fact, you may already have one of these products on your own 
computer. If you don't, you can download the basic software by visiting a Sun 
Microsystems Web site. The product that you want to download is known by 
a few different names. It's called the Java 2 Software Development Kit (SDK), 
the Java Development Kit (JDK), and the Java 2 Standard Edition (J2SE). 

This section tells you how to download and install the Java SDK. First, I give a 
condensed, quick-start set of instructions. Then, I present a detailed, read- 
every-step-carefully version. 
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So what follows is the condensed, quick-start version of instructions for use 
with Microsoft Windows systems. If these instructions are too condensed for 
w the detailed instructions that come immediately after these quick 
ns. 




If you're using Linux, Unix, Macintosh, or some other non-Windows system, 
visit this book's Web site for further instructions. 

1. Visitjava.sun.com. 

2. Find a link to download the J2SE 5.0 (the Java 2 Standard Edition, 
version 5.0). 

If you find some other 1.5.x version, like 1.5.1_02, that's fine. Just make 
sure that you have a version numbered 1. 5. something-or-other or higher. 

3. Download the SDK, not the JRE. 

The JRE (Java Runtime Environment) isn't harmful to your computer, 
but the JRE isn't enough. To create your own Java programs, you need 
more than the JRE. You need the entire SDK. (Besides, when you run the 
install program for the SDK, the install program offers to put both the 
SDK and the JRE on your computer.) 

4. Double-click the icon of the downloaded file and follow the wizard's 
instructions for installing the Java SDK. 

As the installation begins, the wizard asks you to choose from among 
several components that can possibly by installed. You can choose to 
have some or all of the components installed. Just make sure that your 
choice includes the development tools and the JRE. 

You also see the name of the directory in which the Java SDK is to be 
installed. Jot down the exact name of the directory. It's something like 
jdkl . 5 or C:\Program Files\Java\jdkl.5. (For some Java versions, 
the name starts with j2sdk.) Whatever the directory's name is, I call this 
your Java home directory. 

At some point, the wizard asks whether you want to register your Web 
browser with the latest Java plug-in. If you plan to create Java applets, 
accept this option and register your browser. (Even if you won't be writ- 
ing applets, it's a good idea to register your browser.) 

5. Return to the page where you found the SDK download. Get another 
download — the J2SE Documentation (also known as the J2SE API 
Documentation). 

6. Extract the zipped J2SE Documentation to your Java home directory. 

Your Java home directory comes with several subdirectories — bin, j re, 
lib, and a few others. After the extraction, your Java home directory 
has a new directory named docs. I call this new directory your Javadoc 
directory. 
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|vious instructions are too quick for you, you can follow this sec- 
Itailed instructions. 



The Sun Microsystems Web site changes from week to week. By the time you 
read this book, my detailed instructions may be obsolete. So as you read 
these instructions, be ready for some surprises. Be prepared to do some 
hunting on Sun's Java Web site. Expect to find a few options that were added 
to the site after I wrote this chapter. If you get lost, check this book's Web site 
for more up-to-date instructions. 

Here are the detailed instructions for downloading the Java SDK: 



1. Visitjava.sun.com. 

2. On the java . sun. com home page's right margin, look for something 
called Popular Downloads. 

3. Under Popular Downloads, look for a J2SE 5.0 link. 

The next thing you see is a page full of download links. 

Most of the programs in this book run only under Java 1.5.0 beta, or 
later. They do not run under any version earlier than Java 1.5.0 beta. In 
particular, they do not run under Java 1.4 or under Java 1.4.2. 

4. Take a few minutes to examine the download links. 

Depending on what Sun Microsystems has cooking when you visit the 
Web site, you may find variations on the simple J2SE link. You may see 
the word Platform and the abbreviations SDK and JRE. You also see ver- 
sion numbers, such as 5.0. You want the highest version number that's 
available at the Web site. 

Avoid links that are labeled JRE because they lead to the software for 
running existing Java programs, not the software for writing new Java 
programs. It's not bad to have the JRE on your computer, but in order 
to write new Java programs, you need something more powerful than 
the JRE. You need the SDK. (In fact, when you download the SDK, you 
get the JRE along with the SDK. So don't download the JRE separately.) 

5. Click the link to download the latest version of the SDK. 

At java . sun .com, you can find downloads for Windows, Linux, and 
Solaris. If your favorite operating environment isn't Windows, Linux, 
or Solaris, don't despair. Many third-party vendors have converted 
Java to other environments. If the Mac is your thing, visit devel oper . 
apple . com/ j ava. 

Clicking the SDK download link brings you to the Sun Microsystems 
License Agreement page. 
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6. Do whatever you normally do with license agreements. 

I won't be the one to tell you not to bother reading it. If you accept the 
ement, you're taken to yet another Web page. 



if 2 



7. On this final Web page, click the link or button to start the download. 

For Windows, the Web page offers two kinds of installation downloads — 
the regular (online) installation and the offline installation. I prefer the 
offline installation, but you may prefer the online installation. 

• The online installation is good if you want to save space on your 
hard drive. 

Clicking the online installation link puts a tiny file on your hard 
drive. Eventually, your hard drive has one tiny file plus the 
installed Java SDK. 

• The offline installation is good if you ever want to reinstall the 
Java SDK. 

Clicking the offline installation link downloads a huge setup file on 
your hard drive. Eventually, your hard drive has a huge setup file 
plus the installed Java SDK. 

The huge setup file takes an extra 50MB on your hard drive, but if 
you ever want to reinstall Java, you have the setup file right where 
you need it. 

As you begin downloading the tiny online file or the huge offline setup file, 
note the directory on your hard drive where the file is being deposited. 

8. Return to the Web page that you were visiting in Step 4. On that page, 
find a link to the J2SE Documentation (also known as the J2SE API 
Documentation) . 

The Java language has a built-in feature for creating consistent, nicely 
formatted documentation in Web page format. As a Java programmer, 
you won't survive without a copy of the Application Programming 
Interface (API) documentation by your side. You can bookmark the doc- 
umentation at the Java. sun. com site and revisit the site whenever you 
need to look up something. But in the long run (and in the not-so-long 
run), you can save time by downloading your own copy of the API docs. 

See Chapter 3 for more about the API. 

9. Download the API documentation. 

The documentation comes inside a big Zip file. Just leave this file on 
your hard drive for now. You don't unzip the file until you read the next 
section's instructions. 
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download the Java SDK, you're ready to install the software on your 
. Of course, you can do this 900 different ways, depending on your 
operating system, the names of directories on your hard drive, the wind 
velocity, and other factors. The following steps offer some guidelines: 



1. Open My Computer and find the SDK file that you downloaded. 

The file has a name like jdkl . b-bl ah-b 1 ah . exe or j2sdkl . 
5 -yada-yada .exe. The exact name depends on the operating system 
you're using, the version number that Sun has reached with Java, and 
whatever naming conventions the people at Sun have changed since 
book was written. 

2. Double-click the SDK file's icon. 

What happens next depends on which option you chose in Step 7 of the 
previous set of instructions. 

• If you downloaded the tiny online installation file, your computer 
downloads more files from the Internet and installs Java while it 
downloads. 

• If you downloaded the huge offline installation file, your computer 
extracts the contents of the huge setup file and installs Java from 
these contents. 

3. Among the features that you select to install, make sure you select 
Development Tools and Public Java Runtime Environment. (See 
Figure 2-1.) 

You can choose to have some or all of the components installed. Just 
make sure that your choice includes these two items. 

4. Jot down the name of the directory in which the Java SDK is being 
installed and then click Next. 

From one version to the next, the installation package puts Java in differ- 
ent directories on the computer's hard drive. Lately the package has 
installed Java in a directory named C:\Program Files\Java\ jdkl. 5.0. 
During the installation on your computer, you may see a different direc- 
tory name. (One way or another, the name probably has j d k or j 2 s d k 
in it.) 

Take note of this directory name when the installation package displays it. 
(Refer to Figure 2-1.) This directory is called your Java home directory. 
You need the name of this directory in other sections of this chapter and 
in other chapters of this book. 
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Figure 2-1: 

A page 
of the 
Java SDK 
installation 
wizard. 



i Setup 

Select the program features you want installed. 



Select optional features to install from the list below. You can change your choice of features after 
installation by using the Add/Remove Programs utility in the Control Panel 



_'- rvv-l' 'pine it. Tools; 




Feature Description 


t=)-l Demos 




The Java 2 SDK, SE vl.5.0, 


si'l Source Code 




including private j2re 1.5.0. This 


i^?-l Public lava Runtime Environment 




will require 120 MB on your hard 






drive. 



Install to: 

C:\Program Fles\Java\j2sdkl.5.0\ 



Change.. 



If you're a Windows user, P r o g r a m Files is probably part of your Java 
home directory's name. Whenever I tell you to type the directory's name, 
it's a good idea to type an abbreviated version that doesn't include the 
blank space. The official Windows abbreviation for Program Files is 
progra~l (with a squiggly little tilde character and 1 at the end). So if 
my Java home directory is C:\Program Files\Java\jdkl.5.0, then 
when I need to type the directory's name, I usually type C:\progra~l\ 
Java\jdkl.5.0. 

5. When you see a wizard page that offers to install the Java Web browser 
plug-in, accept this option and then click Install. (See Figure 2-2.) 

Installing the plug-in gives you the ability to run Java applets on your 
computer. 

6. Enjoy the splash screens that you see while the software is being 
installed. 

At the end of the installation, you click the proverbial Finish button. But 
you're still not done with the whole kit 'n caboodle. The next step is 
installing the Java documentation. 

7. Copy the documentation to your Java home directory. 

In Step 9 of the previous section, you downloaded a file named 
jdk-l_5_0-doc .zip (or something like that). Unzip (extract) this 
file so that its contents are in your Java home directory. 
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Browser Registration 

j browsers you want to register with Java(TM) Plug-In. 



a 



0 Microsoft Internet Explorer 



B Mozilla 1.1 or later 



Figure 2-2: 

Say "yes" to 
plug-ins. 



You may change the settings later in the JavafTM) Control Panel. 
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Cancel 




Your Java home directory has a name like jdkl . 5. That's not the same 
as another directory that you may find on your hard drive — a directory 
with a name like j 2 r e 1 . 5 . 

8. Check to make sure that you unzipped the documentation correctly. 

After unzipping the documentation's Zip file, you should have a subdi- 
rectory named docs in your Java home directory. So open My Computer 
and navigate to your new ]6kwhatever or )2sdksuch-and-such folder. 
Directly inside that folder, you should see a new folder named docs. 
This directory is called your Javadoc directory. (See Figure 2-3.) 

When your docs are all lined up in a row, you can proceed to the next step — 
installing a Java development environment. 



Figure 2-3: 
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Preparing to Use an Integrated 
DxO\M(HiO)p&ent Environment 

If you followed the instructions up to this point, you have all the software that 
you need for writing and running your own Java programs. But there's one 
more thing you may want. It's called an Integrated Development Environment 
(IDE). If you don't have an IDE, writing and running a program involves opening 
several different windows — a window for typing the program, another window 
for running the program, and maybe a third window to keep track of all the 
code that you've written. An IDE seamlessly combines all this functionality 
into one well-organized application. 

Java has its share of integrated development environments. Some of the 
more popular products include Eclipse, Borland JBuilder, NetBeans, and IBM 
WebSphere. Some fancy environments even have drag-and-drop components 
so that you can design your graphical interface visually. (See Figure 2-4. For 
more info on the neat-o Jigloo graphical user interface builder shown here, 
check out www .cloudgarden. com/ jigloo/index. html.) 



Figure 2-4: 

Using the 
Eclipse IDE 
with the 
Jigloo 
graphical 
user 
interface 
builder. 
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rams in this book work with almost any Java IDE. But in this chapter, 
ou how to use JCreator LE (Lite Edition). I chose JCreator LE over 
other IDEs for several reasons: 

V JCreator LE is free. 

Among all the Java IDEs, JCreator represents a nice compromise 
between power and simplicity. 

t<" Unlike some other Java IDEs, JCreator works with almost any version 
of Java, from the ancient version 1.0.2 to the new-and-revolutionary 
version 5.0. 

JCreator LE is free. (It's worth mentioning twice.) 

If you're the kind of person who prefers plain old text editors and command 
prompts over IDEs, visit this book's Web site. On that site, I've posted instruc- 
tions for writing and running Java programs without an IDE. 

This book's CD-ROM has a special version of JCreator LE — a version that's 
customized especially tor Java 2 For Dummies, 2nd Edition, readers! So please 
install JCreator LE from the CD-ROM. (Who knows? You may like it a lot, and 
buy JCreator Pro!) 

For help installing materials from the CD-ROM, see Appendix A. 



Running JCreator for the first time 

The first time you run JCreator, the program asks for some configuration 
information. Just follow these steps: 

1. If you haven't already done so, launch JCreator. 

The JCreator Setup Wizard appears on your screen. The wizard's first 
page is for File Associations. 

2. Accept the File Associations defaults and click Next. 

The wizard's next page (the JDK Home Directory page) appears. 

3. Look at the text field on the JDK Home Directory page. Make sure 
that this field displays the name of your Java home directory. (See 
Figure 2-5.) 
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Figure 2-5: 

Confirming 
the location 
of your Java 
home 
directory. 
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In order to runJCreator successfully, you need to have a recent 
version of the JDK installed on your system. 



You can download in: iiorn 



Select the JDK home directory : ( e.g. c:\|dkl.4 ) 
C:\Program Fi!esUava\j2sdkl.5.0 



Back I Next | Finish | Cancel I Help 



If the wrong directory name appears in the text field, just click the 
Browse button and navigate to your computer's Java home directory. 

For information on your computer's Java home directory, see Step 4 of 
this chapter's "Downloading and Installing the Java Software 
Development Kit (SDK)" section, or Step 4 of this chapter's "Installing 
Java on your computer" section. 

4. When you're happy with the name in the home directory text field, 
click Next. 

The wizard's last page (the JDK JavaDoc Directory page) appears. 

5. Look at the text field on the JDK JavaDoc Directory page. Make sure 
that this field displays the name of your Javadoc directory. (See 
Figure 2-6.) 



Figure 2-6: 
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Select the JavaDocs home directory : ( e.g. c:\jdk1.4\docs ) 
C:\Program Res'vJava\i2sdk1.5.0\docs ) r, ow < 
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Normally, your Javadoc directory's name is the name of your Java home 
directory, followed by \docs. For information on your computer's Javadoc 
;Ctory, see Step 6 of this chapter's "Downloading and Installing the Java 
are Development Kit (SDK)" section, or Step 8 of this chapter's 
Installing Java on your computer" section. 





If the wrong directory name appears in the text field, just click the 
Browse button and navigate to your computer's Javadoc directory 

If you do anything wrong in Steps 3 or 4 above, you can correct your 
mistake later. See this book's Web site for details. 

6. Click Finish. 

At this point, the JCreator work area opens. (See Figure 2-7.) 

In JCreator's help files, the stuff in Figure 2-7 is called the workspace, not the 
work area. But elsewhere in these help files, JCreator reuses the word work- 
space to mean something entirely different. To avoid any confusion, I use two 
different terms. I use work area for the stuff in Figure 2-7, and I use workspace 
for that other, entirely different thing. (I explain that entirely different thing 
later in this chapter in the section entitled "Running a text-based program.") 



Figure 2-7: 
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iction, you run three Java programs — programs I wrote to help you 
practice running some Java code. Each program computes the monthly pay- 
ment on a home mortgage, but each program interacts with the user in its 
own unique way. After you make your way through this section, you'll know 
how to run three kinds of programs: a text-based program, a stand-alone GUI 
program, and a Java applet. 



Running a text-based program 

The first mortgage-calculating program doesn't open its own window. 
Instead, the program runs in JCreator's General Output pane. (See Figure 2-8.) 
A program that operates completely in this General Output pane is called a 
text-based program. 



Figure 2-8: 

A run of the 
text-based 
mortgage 
program. 
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Configuration: Program0201 - j 2sdkl . 

How much are you borrowing? 100000.00 
What ' s the interest rate? 5 . 25 
How many years are you taking to pay? 30 

Your monthly payment is $552.20 
Process completed. 


5,0 <Default> - <Default>- 
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If you're using Linux, Unix, Mac, or some other non-Windows system, the 
instructions in this section don't apply to you. Visit this book's Web site for 
an alternative set of instructions. 



Actually, as you run the mortgage program, you see two things in the General 
Output pane: 

i>* Messages and results that the mortgage program sends to you. 

Messages include things like How much are you borrowi ng? Results 
include lines like Your monthly payment is $552.20. 

V Responses that you give to the mortgage program while it runs. If you 

type 100000.00 in response to the program's question about how much 
you're borrowing, you see that number echoed in the General Output 
pane. 

Running the mortgage program is easy. Here's how you do it: 

1. Make sure that you've followed the previous instructions in this 
chapter — instructions for installing the Java SDK and configuring 
JCreator. 
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ie WenaTTieS displayed in My Computer or in 
Windows Explorer can be misleading. You 
may visit the MyProjects\Program0203 
directory and see the name MyWebPage. 
Instead of just MyWebPage, the file's full 
name is MyWebPage . html . You may see two 
MortgageApplet files. What you don't see is 
that one file's real name isMortgageApplet. 
java, and the other file's real name is 
MortgageApplet. class. 

The ugly truth is that My Computer and 
Windows Explorer can hide a file's extensions. 
This awful feature tends to confuse Java pro- 
grammers. So, if you don'twantto be confused, 
modify the Windows Hide Extensions feature. To 



do this, you have to open the Folder Options 
dialog box. Here's how: 

In Windows 95, 98, or NT: In the Windows 
Explorer menu bar, choose ViewOFolder 
Options (or just ViewCOptions). 

In Windows ME or 2000: Choose StartO 
SettingsOControl PanelOFolder Options. 

e" In Windows XP: Choose StartOControl 
PanelOPerformance and Maintenance^ 
File Types. 

In the Folder Options dialog box, clickthe View 
tab. Then look for the Hide File Extensions for 
Known File Types option. Make sure that this 
check box is not selected. 



Thank goodness! You don't have to follow those instructions more than 
once. 

2. Launch JCreator. 

The big JCreator work area stares at you from your computer screen. 
(Refer to Figure 2-7.) 

If this is your first time running JCreator, you don't see JCreator's work 
area. Instead you see the JCreator Setup Wizard. To get past the Setup 
Wizard, follow the instructions in the section entitled "Running JCreator 
for the first time" in this chapter. 

3. In JCreator's menu bar, choose FileOOpen Workspace from the main 
menu. 

Don't choose Fi\e<>Open. Instead, choose Fi\e<>Open Workspace. 

A familiar-looking Open dialog box appears. This dialog box looks in 
your My Projects directory. This My Projects directory is a subdirec- 
tory of the directory in which JCreator is installed. 

The MyProjects directory has subdirectories named Program0201, 
Listing0302, and so on. The MyProjects directory also has files with 
names HkeChapter02 and Chapter03.If you set your computer so that 
it doesn't hide file extensions for known file types, then the names of the 
files are Chapter02 .jew, Chapter03 .jew, and so on. (See the sidebar 
entitled "Those pesky filename extensions.") 
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Select the file named Chapter02 (or Chapter02.jcw), and then click 
Open. 

ing Open may coax out a message box asking if you want to "Save 
orkspace modifications?" If so, click Yes. Clicking Open may coax 
out another box asking if you want to ". . . close all document Windows?" 
If so, click Yes. 

JCreator divides things into workspaces. Each workspace is further sub- 
divided into projects. To organize this book's examples, I made a work- 
space for each chapter, and then made a project for each complete Java 
program. When you open Chapter02 . jew, you get my Chapter02 work- 
space — a workspace that contains three projects. The projects' names 
are Program0201, Program0202, and Program0203. That's why, in 
JCreator's File View pane, you see aChapter02 tree with branches 
labeled Program0201, Program0202, and Program0203. (See Figure 2-9.) 

In the File View's tree, right-click the branch labeled Program0201. 
In the resulting context menu, choose Sets as Active Project. (See 
Figure 2-9.) 

Choosing Sets as Active Project makes Program0201 the active project. 



Figure 2-9: 
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In JCreator, only one project at a time can be the active project. To run a 
particular program, the program's code has to be in whatever project is 
ently active. In JCreator's File View, you can tell which project is 
e by looking for the project whose name is boldface. (See Figure 2-9 
once again.) On some systems, the active project's name is a hazy, light- 
gray boldface. 

If a particular program isn't in the active project, you can't run that pro- 
gram, but you can do some other things with that program. For instance, 
you can see the program in one of JCreator's panes, make changes to the 
program, save the program, and so on. For this reason, it's really easy to 
get confused and forget which project is active. So always keep the 
active project in the forefront of your mind. If your code doesn't do what 
you think it should do, check to make sure that the project you want to 
run is the active project. 

Choose BuildOCompile Project from the main menu. 

Choosing Compile Project does exactly what it says. It compiles the pro- 
ject's code. (To find out what compile means, see the sidebar entitled 
"Compiling and running a Java program.") 

After some pleasant chirping sounds from your hard drive, JCreator's 
bottom pane displays a Process compl eted message. (See Figure 2-10.) 



Figure 2-10: 
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7. Choose BuildOExecute Project from the main menu. 

When you choose Execute Project, the computer runs the project's 
code. (That is, the computer runs a Java program that I wrote.) As part 
of the run, the message How much are you borrowi ng? appears in 
JCreator's General Output pane. (Refer to Figure 2-8.) 

8. Click anywhere inside JCreator's General Output pane, and then type 
a number, like 100000.00, and press Enter. 

When you type a number in Step 8, don't include your country's currency 
symbol and don't use a grouping separator. (U.S. residents, don't type a 
dollar sign and don't use commas.) Things like $100000.00 or 100,000.00 
cause the program to crash. You see a NumberFormatExcepti on message 
in the General Output pane. 
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After you press Enter, the Java program displays another message 
(What's the interest rate?) in JCreator's General Output pane. 



sponse to the interest rate question, type a number, like 5.25, and 
s Enter. 



After you press Enter, the Java program displays another message (How 
many years . . . ?) in JCreator's General Output pane. 

10. Type a number, like 30, and press Enter. 

In response to the numbers that you've typed, the Java program dis- 
plays a monthly payment amount. Again, refer to Figure 2-8. (Disclaimer: 
Your local mortgage company will charge you much more than the 
amount that my Java program calculates.) 

When you type a number in Step 10, don't include a decimal point. Things 
like 30.0 cause the program to crash. You see a NumberFormatExcepti on 
message in the General Output pane. 

Occasionally you decide in the middle of a program's run that you've 
made a mistake of some kind. You want to stop the program's run dead 
in its tracks. To do this, choose ToolsOStop Tool from the main menu. 



Running a GUI on its ou)n 

In the previous section, you go through all the steps for compiling and run- 
ning a text-based Java program. In this section, you go through the same 
steps for a GUI. The term GUI stands for Graphical User Interface. It's the term 
used for a program that displays windows, buttons, and other nice-looking 
stuff. GUI programs are good because, unlike text-based programs, they don't 
look like they're running on your grandparents' computers. 

If you installed JCreator from this book's CD-ROM, you can find a GUI version 
of the mortgage-calculating program in a project named Program0202. To run 
the program, just follow these instructions: 

1. If you haven't already done so, follow Steps 1 to 4 from the section 
entitled "Running a text-based program." 

When you finish with these steps, the Chapter02 workspace is open. 




JCreator remembers which workspace is open from one launch to another. 
So, if you ran the text-based program and then closed JCreator, you can 
just launch JCreator and skip the steps for opening the Chapter02 work- 
space (Steps 3 and 4 in the text-based program section). 



Chapter 2: Running Canned Java Programs 



DropBooks 

t 3. Folk 



2. In the File View's tree, right-click the branch labeled Program0202. In 
the resulting context menu, choose Sets as Active Project. 

makes Program0202 the active project. 

3. Follow Steps 6 and 7 in the "Running a text-based program" section. 

This compiles and runs the Program0202 project's code. The code dis- 
plays a window like the one shown in Figure 2-11. In the window, you can 
experiment and type your own values for the principal, the interest rate, 
and the number of years of the loan. Whenever you change a value, the 
program responds instantly by updating the value in the Payment field. 





^ Mortgage Payment Calculator ESQ 
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Running a GUI on a Web page 
(aJaOa applet) 

Java's big splash onto the scene came in the mid-1990s. The people at Sun 
Microsystems had managed to work Java programs into Web pages, and the 
results were dazzling. The infusion of Java into the Web was powerful, effi- 
cient, portable, and secure. The trick was to create a part of a program, 
called an applet, and to display the applet inside a rectangle on the Web page. 

These days, applets are passe. Real Java programmers roll their eyes when 
they hear the word applet. There are three reasons for this: 

Since the mid-1990s, better technologies have emerged for putting eye- 
catching content onto Web pages. 

Microsoft, the makers of the world's most powerful Web browser, 
refused to give their browser the most up-to-date Java tools. 

For Java programmers, the real money isn't in creating glittery Web 




pages. The real money is in business applications with J2EE. 
For more information on J2EE, see Chapter 3. 
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7haffloe!ntmeairror JCreatorto "compile your 
project?" A compiler is a tool that translates 
code from one form to another. For instance, in 
my Program0201 project directory, I have a 
file named MortgageText. Java. If you look 
inside the MortgageText . Java file, you see 
code like this: 

import Java . i o . * ; 
import Java .text. NumberFormat ; 
public class MortgageText ( 
public static void 

main(String args[]) throws 

IOExcepti on 

Although this code isn't easy reading, it cer- 
tainly uses letters and other characters that 
English-speaking people can understand. This 
file, MortgageText . j ava, is called Java 
source code. It's the kind of code that you find 
out how to write by reading this book. It's the 
code that you have before you've done any 
compiling — before you choose BuildOCompile 
Project from JCreator's main menu. 

When you choose BuildOCompile Project, the 
computer takes your source code and trans- 
lates it into something called bytecode. The 
newly created bytecode file is automatically 
given a name like MortgageText.class. (You can 
open My Computer and look for the new 
.class file in your Program0201 directory.) 
Unlike the original . Java file, the new .class 
file has no recognizable characters in it and isn't 
suitable for human consumption. Instead, the 
. cl ass file is streamlined so that the computer 
can carry out your program's commands quickly 
and easily. 

In the way that it compiles code, Java repre- 
sents a strict departure from most other pro- 
gramming languages. When you compile a 
program in another language (COBOL or C++, 
for instance), you create a file that can be run 
on only one operating system. For example, 
if you compile a C++ program on a Windows 



computer and then move the translated file to a 
Mac, the Mac treats the translated file as pure 
garbage. The Mac can't interpret any of the 
instructions in the translated file. This is bad for 
many reasons. One of the most striking reasons 
is that you can't send this kind of code over the 
World Wide Web and expect anyone with a 
different kind of computer to be able to run the 
code. 

But with Java, you can take a bytecode file that 
you created with a Windows computer, copy the 
bytecode to who-knows-what kind of computer, 
and then run the bytecode with no trouble at all. 
That's one of the many reasons why Java has 
become popular so quickly. This outstanding 
feature, the ability to run code on many differ- 
ent kinds of computers, is called portability. 

After compiling your Java project, choose 
BuildOExecute from the main menu. At this 
point, I normally say that your computer starts 
running a Java program. But to be really picky, 
your computer never actually "runs a Java pro- 
gram." Instead, your computer runs something 
called the Java Virtual Machine (JVM). The use 
of a virtual machine is another way in which 
Java is differentfrom other computer program- 
ming languages. 

The Java Virtual Machine is a piece of software. 
Think of the JVM as a proxy, an errand boy, a 
go-between. The JVM serves as an interpreter 
between Java's run-anywhere bytecode and 
your computer's own system. As it runs, the 
JVM walks your computer through the execu- 
tion of bytecode instructions. The JVM exam- 
ines your bytecode, bit by bit, and carries out 
the instructions described in the bytecode. The 
JVM interprets bytecode for your Windows 
system, your Mac, your Linux box, or whatever 
kind of computer you're using. That's a good 
thing. It's what makes Java programs more 
portable than any other language's programs. 
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Passe or not, some people still want to create applets. So in this section, you 
run a simple Java applet. Just follow these steps: 



u haven't already done so, follow Steps 1 to 4 from the section 
entitled "Running a text-based program." 

When you finish with these steps, the Chapter02 workspace is open. 

2. In the File View's tree, right-click the branch labeled Program0203. In 
the resulting context menu, choose Sets as Active Project. 

This makes Program0203 the active project. 

3. Follow Steps 6 and 7 in the "Running a text-based program" section. 

This compiles and runs the Program0202 project's code. You see a new 
Web page containing a mortgage applet in the Web browser window. 
(See Figure 2-12.) 
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If you follow the steps in this section, and you don't see the mortgage applet 
running in your Web browser, you can do a few things: 

Check your Web browser's settings to make sure that the display of 
Java applets is enabled. 

u* Make sure that you installed the Java plug-in. 

See Step 5 of the section entitled "Installing Java on your computer." 

Close any browser windows that you have open. Then return to 
JCreator and choose BuildOExecute Project again. 

Sometimes this helps. 

Skip the whole applet business and move on to Chapter 3. 

Hardly anyone uses Java applets these days anyway. 
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i tms cfrapter, yotrcan find a sidebar entitled 
"Compiling and running a Java program." The 
sidebar describes the execution of a Java pro- 
ject. To execute a project, your computer runs 
a Java Virtual Machine (JVM), and this JVM 
carries a Java program's instructions. That's 
how it works for a project that doesn't involve 
applets. But when your project involves an 
applet, the story is a bit different. 

If you've worked with Web pages, you may be 
familiar with something called HTML — the 
Hypertext Markup Language. It's the universal 
language for the World Wide Web. Almost every 
Web page starts with an HTML file. That's why, 
when you expand Program0203 in JCreator's 
File View pane, you see something named 
MyWebPage . html . 

When JCreator executes the Program0203 
project, it finds this MyWebPage.html file, 
and opens this file with Microsoft Internet 
Explorer. At this point, Internet Explorer takes 
onthefull burden of running your code. Internet 
Explorer acts on the commands (the tags) in the 
MyWebPage . html file. In particular, Internet 
Explorer finds the following tag inside the 
MyWebPage . html file: 

<applet code="MortgageAppl et" 
width=300 

height=200X/applet> 



This tag instructs Internet Explorer to look for 
the Java program named MortgageAppl et. 
When it finds the program, Internet Explorer 
displays the applet (the text fields, the words 
Principal, Rate, Payment, and other stuff) in the 
browser window. 

So that's what JCreator does when you want 
an applet to be executed. JCreator doesn't 
run the JVM directly. Instead, JCreator tells 
Internet Explorer to visit an HTML document. 
Then Internet Explorer runs the JVM and dis- 
plays the applet on a Web page. Have you read 
about all the lawsuits between Microsoft and 
Sun Microsystems? At the heart of these law- 
suits is the use of an outdated JVM in the 
Internet Explorer browser. 

By the way, if JCreator doesn't find Internet 
Explorer on your system, then JCreator opens 
the file with Sun's appletviewer. The 
appletviewer'is a small browserthat's designed 
specifically for viewing Java applets. The 
appletviewer displays nothing but applets (no 
hyperlinks, no images, no text other than the 
applet's text) so you can't use appletviewer to 
preview a complete Web page. 
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In This Chapter 

Speaking the Java language: the API and the Language Specification 

Understanding the parts of a simple program 

Documenting your code 

Editing and running a Java program 



rhe quotation applies to all kinds of things — things like life, love, and 
computer programming. That's why this chapter takes a multilayered 
approach. In this chapter, you get your first blast of details about Java pro- 
gramming. But in discovering details, you see the simplicities. 



If you try to picture in your mind the whole English language, what do you 
see? Maybe you see words, words, words. (That's what Hamlet saw.) Looking 
at the language under a microscope, you see one word after another. The 
bunch-of-words image is fine, but if you step back a bit, you may see two 
other things: 

The language's grammar 
V Thousands of expressions, sayings, idioms, and historical names 



'All great ideas are simple. 



— Leo Tolstoy 



Speaking the Jatfa Language 



The first category (the grammar) includes rules like, "The verb agrees with 
the noun in number and person." The second category (expressions, sayings, 
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and stuff) includes knowledge like, "Julius Caesar was a famous Roman 
emperor, so don't name your son Julius Caesar, unless you want him to get 
ivery day after school." 



The Java programming language has all the aspects of a spoken language like 
English. Java has words, grammar, commonly used names, stylistic idioms, 
and other such things. 



The grammar and the common names 

The people at Sun Microsystems who created Java thought of Java as coming 
in two parts. Just as English has its grammar and commonly used names, 
the Java programming language has its specification (its grammar) and its 
Application Programming Interface (its commonly used names). Whenever I 
write Java programs, I keep two important pieces of documentation — one 
for each part of the language — on my desk: 



W The Java Language Specification: This includes rules like, "Always put 
an open parenthesis after the word for" and "Use an asterisk to multiply 
two numbers." 

f The Application Programming Interface: Java's Application Programming 
Interface (API) contains thousands of tools that were added to Java after 
the language's grammar was defined. These tools range from the common- 
place to the exotic. For instance, the tools include a routine named pow 
that can raise 5 to the 10th power for you. A more razzle-dazzle tool 
(named JFrame) displays a window on your computer's screen. Other 
tools listen for the user's button clicks, query databases, and do all 
kinds of useful things. 



You can download the Language Specification, the API documents, and all the 
other Java documentation (or view the documents online) by poking around 
at java . sun . com/j 2se/l . 5 . 0/downl oad. j sp and atjava.sun.com/j2se/ 
1.5. 0/docs/i ndex . html . But watch out! These Web pages are moving tar- 
gets. By the time you read this book, the links in this paragraph will probably 
be out of date. The safest thing to do is to start atjava.sun.com/j2se, and 
then look for links to things like "version 5.0" and "documentation." 



The first part of Java, the Language Specification, is relatively small. That 
doesn't mean you won't take plenty of time finding out how to use the rules 
in the Language Specification. Other programming languages, however, have 
double, triple, or ten times the number of rules. 



The second part of Java — the API — can be intimidating because it's so 
large. The API contains at least 3,000 tools and keeps growing with each new 
Java language release. Pretty scary, eh? Well, the good news is that you don't 
have to memorize anything in the API. Nothing. None of it. You can look up 
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the stuff you need to use in the documentation and ignore the stuff you don't 
need. What you use often, you'll remember. What you don't use often, you'll 
e any other programmer). 



For information on how to find things in Java's API documentation, see the 
section entitled "Finding javadoc pages," later in this chapter. 

No one knows all there is to know about the Java API. If you're a Java pro- 
grammer who frequently writes programs that open new windows, you know 
how to use the API Frame class. If you seldom write programs that open win- 
dows, the first few times you need to create a window, you can look up the 
Frame class in the API documentation. My guess is that if you took a typical 
Java programmer and kept that programmer from looking up anything in the 
API documentation, the programmer would be able to use less than 2 percent 
of all the tools in the Java API. 



Sure, you may love the For Dummies style. But unfortunately, Java's official 
API documentation isn't written that way. The API documentation is both 
concise and precise. For some help deciphering the API documentation's lan- 
guage and style, see this book's Web site. 

In a way, nothing about the Java API is special. Whenever you write a Java 
program — even the smallest, simplest Java program — you create a class 
that's on par with any of the classes defined in the official Java API. The API is 
just a set of classes and other tools that were created by ordinary program- 
mers who happen to participate in the official JCP — the Java Community 
Process. Unlike the tools that you create yourself, the tools in the API are dis- 
tributed with every version of Java. (I'm assuming that you, the reader, are 
not a participant in the Java Community Process. But then, with a fine book 
like Java 2 For Dummies, 2nd Edition, one never knows.) 

If you're interested in the JCP's activities, visit www.jcp.org. 

The folks at the JCP don't keep the Java programs in the official Java API a 
secret. If you want, you can look at all these programs. When you install Java 
on your computer, the installation puts a file named src.zip on your hard 
drive. You can open src.zip with your favorite unzipping program. There, 
before your eyes, is all the Java API code. 



The Words in a JaVa program 

A hard-core Javateer will say that the Java programming language has two 
different kinds of words: keywords and identifiers. This is true. But the bare 
truth, without any other explanation, is sometimes misleading. So I recommend 
dressing up the truth a bit and thinking in terms of three kinds of words: key- 
words, identifiers that ordinary programmers like you and me create, and 
identifiers from the API. 
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"has an Application Programming Interface" is 
a bit misleading. In fact, Java has several APIs: 

u 0 J2SE: The most widely used API is called 
J2SE — the Java 2 Standard Edition. If you 
run Java on a desktop computer or even 
on a mainframe of some kind, you're 
almost certainly running code from this 
Standard Edition. Among other things, this 
API includes code that writes text to the 
screen, displays numbers in several for- 
mats, and stores large collections of values. 
Without something like this API, Java would 
be a fairly useless computer programming 
language. 

When you follow the instructions in Chapter 
2, and you download something called j d k 
or j2sdk, you're getting Java with its 
Standard Edition API. 

J2EE: In the abbreviation J2EE, the extra 
£ stands for Enterprise. No, it's not the 
API that's used on Star Trek. It's a collection 
of code that streamlines large business 
processes. J2EE code talks to large data- 
bases and handles customers by the mil- 
lions. If you've ever heard of something 
called Enterprise JavaBeans, you've heard 
of one aspect of J2EE. Another part of J2EE 
(called JavaServer Pages) creates dynamic 
Web pages for shopping carts and other 
applications. 

As a newcomer to Java, you'll probably 
have very little contact with J2EE. Even so. 



stew 

be aware that J2EE exists. Most big busi- 
nesses use either J2EE or its competitor 
(the massive .NET Framework from 
Microsoft). If you want to earn some bucks 
writing computer programs, finding out how 
to use J2EE should be part of your long-term 
plans. 

J2ME: Cellphones are small. There's no 
room inside a cellphone for something like 
J2SE. Besides, the J2SE code solves desk- 
top computer problems, and little handheld 
appliances have their own special kinds 
of problems. All things considered, J2SE is 
a poor fit for a pager, a smart card, or a 
cable-converter box. So the people who 
develop Java have created a third API 
called J2ME — the Java 2 Micro Edition. 
This API includes tools for telephony, wire- 
less communications, and gaming. It's very 
cool stuff. 

Miscellaneous APIs: If you visit Java, 
sun . com/othertech, you find several 
projects that aren't yet incorporated into 
J2anythingE. Other such projects are lurk- 
ing at www.jcp.org. These works-in- 
progress include peer-to-peer networking, 
dynamic systems management, and some 
other futuristic goodies. Much of the code 
that's now in one of the three major APIs 
started off in this miscellaneous category. 
Many concepts that begin as miscella- 
neous fragments eventually graduate to 
become part of a major Java standard. 



The differences among these three kinds of words are similar to the differences 
among words in the English language. In the sentence "Sam is a person," the 
word person is like a Java keyword. No matter who uses the word person, the 
word always means roughly the same thing. (Sure, you can think of bizarre 
exceptions in English usage, but please don't.) 
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The word Sam is like a Java identifier because Sam is a name for a particular 
person. Words like Sam, Dinswald, and McGillimaroo don't come prepacked 
ning in the English language. These words apply to different people 
g on the context and become names when parents pick one for their 
newborn kid. 



Now consider the sentence "Julius Caesar is a person." If you utter this sen- 
tence, you're probably talking about the fellow who ruled Rome until the Ides 
of March. Although the name Julius Caesar isn't hard-wired into the English 
language, almost everyone uses the name to refer to the same person. If 
English were a programming language, the name Julius Caesar would be an 
API identifier. 

So here's how I, in my own mind, divide the words in a Java program into 
categories: 

v* Keywords: A keyword is a word that has its own special meaning in the 
Java programming language, and that meaning doesn't change from one 
program to another. Examples of keywords in Java include if, else, and 
do. The Cheat Sheet in the front of this book has a complete list of Java 
keywords. 

The JCP committee members, who have the final say on what constitutes 
a Java program, have chosen all of Java's keywords. Thinking about the 
two parts of Java, which I discuss in "The grammar and the common 
names" section earlier in this chapter, the Java keywords belong solidly 
to the Language Specification. 

Identifiers: An identifier is a name for something. The identifier's mean- 
ing can change from one program to another, but some identifiers' mean- 
ings tend to change more than others. 

• Identifiers created by you and me: As a Java programmer (yes, 
even as a novice Java programmer), you create new names for 
classes and other things that you describe in your programs. Of 
course, you may name something Pri me, and the guy writing code 
two cubicles down the hall can name something else Prime. That's 
okay because Java doesn't have a predetermined meaning for the 
word Prime. In your program, you can make Pri me stand for the 
Federal Reserve's prime rate. And the guy down the hall can make 
Pri me stand for the "bread, roll, preserves, and prime rib." A con- 
flict doesn't arise, because you and your co-worker are writing two 
different Java programs. 

• Identifiers from the API: The JCP members have created names 
for many things and thrown at least 3,000 of these names into the 
Java API. The API comes with each version of Java, so these names 
are available to anyone who writes a Java program. Examples of 
such names are String, Integer, JWindow, JButton, JTextField, and File. 
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Strictly speaking, the meanings of the identifiers in the Java API are not cast 
in stone. Although you can make up your own meanings for the words like 
'tarun Window, this isn't a good idea. If you did, you would confuse the 
S^ig^ut of other programmers, who are used to the standard API mean- 
ings for these familiar identifier names. But even worse, when your code 
assigns a new meaning to an identifier like Button, you lose any computa- 
tional power that was created for the identifier in the API code. The program- 
mers at Sun Microsystems did all the work writing Java code to handle 
buttons. If you assign your own meaning to the word Button, you're turning 
your back on all the progress made in creating the API. 



Checking Out Jatfa Code 
(or the First Time 

The first time you look at somebody else's Java program, you tend to feel a 
bit queasy. The realization that you don't understand something (or many 
things) in the code can make you nervous. I've written hundreds (maybe 
thousands) of Java programs, but I still feel insecure when I start reading 
someone else's code. 

The truth is that finding out about a Java program is a bootstrapping experi- 
ence. First you gawk in awe of the program. Then you run the program to see 
what it does. Then you stare at the program for a while or read someone's 
explanation of the program and its parts. Then you gawk a little more and run 
the program again. Eventually, you come to terms with the program. (Don't 
believe the wise guys who say they never go through these steps. Even the 
experienced programmers approach a new project slowly and carefully.) 

In Listing 3-1, you get a blast of Java code. (Like all novice programmers, 
you're expected to gawk humbly at the code.) Hidden in the code, I've placed 
some important ideas, which I explain in detail in the next section. These 
ideas include the use of classes, methods, and Java statements. 



Listing 3-1 : The Simplest Java Program 

class Displayer { 

public static void main(String args[]) { 

System . out . pri ntl n ( "You ' 1 1 love Java!"); 

) 

) 



To see the code of Listing 3-1 in the JCreator work area, follow these steps: 
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1. Open the Chapter03 workspace, and within that workspace, make 
Listing0301 the active project. (See Chapter 2 for details.) 

e File View pane's tree, the name Listing0301 is set in boldface, 
er L i s t i n g 03 0 1 , you see a branch labeled Displayer.java. 



2. Double-click the Di spl ayer . ja va branch in the File View pane's tree. 

JCreator's Editor pane appears on the right side of the work area. The 
Editor pane contains the code in Listing 3-1. 

After following the first step above, you can run the code in Listing 3-1 by 
choosing BuildOCompile Project, and then choosing BuildOExecute Project. 
(See Chapter 2 for details.) 

When you run the program from Listing 3-1, the computer displays You'll 
love Java! (See Figure 3-1.) Now, I admit that writing and running a Java 
program is a lot of work just to get Y o u ' 1 1 love J a v a ! to appear on some- 
body's computer screen, but every endeavor has to start somewhere. 

In the following section, you do more than just run the program and admire 
the program's output. After you read the following section, you actually 
understand what makes the program in Listing 3-1 work. 
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Understanding the Simple Jatfa Program 

This section presents, explains, analyzes, dissects, and otherwise demystifies 
the Java program shown previously in Listing 3-1. 



The JaVa class 

Because Java is an object-oriented programming language, your primary goal 
is to describe classes and objects. (If you're not convinced about this, read 
the sections on object-oriented programming in Chapter 1.) 

On those special days when I'm feeling sentimental, I tell people that Java is 
more pure in its object-orientation than most other so-called object-oriented 
languages. I say this because, in Java, you can't do anything until you've cre- 
ated a class of some kind. It's like being on Jeopardy!; hearing Alex Trebec 
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say, "Let's go to a commercial;" and then interrupting him by saying, "I'm 
sorry, Alex. You can't issue an instruction without putting your instruction 
lass." 



, the entire program is a class. I wrote the program, so I get to make up a 
name for my new class. I chose the name Displayer, because the program dis- 
plays a line of text on the computer screen. That's why the code in Listing 3-1 
starts with class Displayer. (See Figure 3-2.) 



The entire program 



Figure 3-2: 
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Class Displayer { 

public static void main(Strinc 
System. out .println ( "You 1 11 

} 

} 


j args [ ] ) { 
love Java ! " ) ; 


The class 


Displayer 





The first word in Listing 3-1 , the word class, is a Java keyword. (See the section 
"The words in a Java program," earlier in this chapter.) No matter who writes a 
Java program, the word class is always used the same way. On the other hand, 
the word Displayer in Listing 3-1 is an identifier. I made up the word Displayer 
while I was writing this chapter. The word Displayer is the name of a particular 
class — the class that I'm creating by writing this program. 




The Java programming language is case-sensitive. This means that if you 
change a lowercase letter in a word to an uppercase letter, you change the 
word's meaning. Changing case can make the entire word go from being 
meaningful to being meaningless. In the first line of Listing 3-1, you can't 
replace class with Class. If you do, the whole program stops working. 



The JaVa method 

You're working as an auto mechanic in an upscale garage. Your boss, 
who's always in a hurry and has a habit of running words together, says, 
"FixTheAlternator on that junkyOldFord." Mentally, you run through a list 
of tasks. "Drive the car into the bay, lift the hood, get a wrench, loosen the 
alternator belt," and so on. Three things are going on here: 
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You have a name for the thing you're supposed to do. The name is 
FixTheAlternator. 
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pur mind, you have a list of tasks associated with the name 
'heAlternator. The list includes "Drive the car into the bay, lift the 
hood, get a wrench, loosen the alternator belt," and so on. 

You have a grumpy boss who's telling you to do all this work. Your boss 
gets you working by saying, "FixTheAlternator." In other words, your boss 
gets you working by saying the name of the thing you're supposed to do. 

In this scenario, using the word method wouldn't be a big stretch. You have a 
method for doing something with an alternator. Your boss calls that method 
into action, and you respond by doing all the things in the list of instructions 
that you've associated with the method. 

If you believe all that (and I hope you do), then you're ready to read about 
Java methods. In Java, a method is a list of things to do. Every method has a 
name, and you tell the computer to do the things in the list by using the 
method's name in your program. 

I've never written a program to get a robot to fix an alternator. But, if I did, 
the program may include a FixTheAlternator method. The list of instruc- 
tions in my FixTheAlternator method would look something like the text 
in Listing 3-2. 



Listing 3-2: A Method Declaration 

void FixTheAlternator( ) { 
DriveInto(car, bay); 
Lift(hood) ; 
Get(wrench ) ; 
Loosen(alternatorBelt); 



Somewhere else in my Java code (somewhere outside of Listing 3-2), I need an 
instruction to call my Fi xTheAl ternator method into action. The instruction 
to call the FixTheAlternator method into action may look like the line in 
Listing 3-3. 



Listing 3-3: A Method Call 

F i xT h eA 1 ternator (junky 01 dFord); 

Don't scrutinize Listings 3-2 and 3-3 too carefully All the code in Listings 3-2 
and 3-3 is fake! I made up this code so that it looks a lot like real Java code, 
but it's not real. What's more important, the code in Listings 3-2 and 3-3 isn't 
meant to illustrate all the rules about Java. So, if you have a grain of salt 
handy, take it with Listings 3-2 and 3-3. 
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Now that you have a basic understanding of what a method is and how it 
works, you can dig a little deeper into some useful terminology: 



being lazy, I refer to the code in Listing 3-2 as a method If I'm not 
being lazy, I refer to this code as a method declaration. 

The method declaration in Listing 3-2 has two parts. The first line (the 
part with FixTheAlternator in it, up to but not including the open 
curly brace) is called a method header. The rest of Listing 3-3 (the part 
surrounded by curly braces) is a method body. 

f" The term method declaration distinguishes the list of instructions in 
Listing 3-2 from the instruction in Listing 3-3, which is known as a 
method call. 



A method's declaration tells the computer what happens if you call the 
method into action. A method call (a separate piece of code) tells the com- 
puter to actually call the method into action. A method's declaration and 
the method's call tend to be in different parts of the Java program. 



The main method in a program 

Figure 3-3 has a copy of the code from Listing 3-1. The bulk of the code con- 
tains the declaration of a method named main. (Just look for the word main 
in the code's method header.) For now, don't worry about the other words in 
the method header — the words public, static, void, String, and args. I explain 
these words in the next several chapters. 



The main method's header 

class Displayer { 









public static void main (String args [ ] ) 


{ 








System. out . println ( "You 1 11 love Java 

} 


! " ) ; 







Figure 3-3: 

The main 
method. 



The main method (also 

known as the main 
method's declaration) 



The main 
method's body 
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Like any Java method, the ma i n method is a recipe. 
^\>^ ifi make biscuits: 

DropBooft^ 

Bake the rolled dough. 

or 

How to follow the main instructions for a Displayer: 
Print "You'll love Java!" on the screen. 

The word main plays a special role in Java. In particular, you never write 
code that explicitly calls amain method into action. The word main is the 
name of the method that is called into action automatically when the pro- 
gram begins running. 



0mn 




So look back at Figure 3-1. From within JCreator you choose BuildC Execute 
Project to run the Di spl ayer program. When the Di spl ayer program runs, 
the computer automatically finds the program's main method and executes 
any instructions inside the method's body. In the Di spl ayer program, the 
main method's body has only one instruction. That instruction tells the com- 
puter to print You ' 1 1 love Java ! on the screen. So in Figure 3-1, You ' 1 1 
love Java! appears in JCreator's General Output pane. 

None of the instructions in a method are executed until the method is called 
into action. But, if you give a method the name main, that method is called 
into action automatically. 

Almost every computer programming language has something akin to Java's 
methods. If you've worked with other languages, you may remember things 
like subprograms, procedures, functions, subroutines, subprocedures, or 
PERFORM statements. Whatever you call it in your favorite programming lan- 
guage, a method is a bunch of instructions collected together and given a 
new name. 



Hou) you finally tell the computer 
to do something 

Buried deep in the heart of Listing 3-1 is the single line that actually issues a 
direct instruction to the computer. The line, which is highlighted in Figure 3-4, 
tells the computer to display You'll love Java! This line is known as a 
statement. In Java, a statement is a direct instruction that tells the computer to 
do something (for example, display this text, put 7 in that memory location, 
make a window appear). 
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Figure 3-4: 

A Java 
statement. 



Class Displayer { 

»blic static void main (String args [ ] ) { 



System. out .println ( "You ' 11 love Java! 



A statement (a call to the 

System. out.println method) 



Of course, Java has different kinds of statements. A method call, which I 
introduce in "The Java method," earlier in this chapter, is one of the many 
kinds of Java statements. Listing 3-3 shows you what a method call looks like, 
and Figure 3-4 also contains a method call that looks like this: 

System . out . pri ntl n ( "You ' 1 1 love Java!"); 




When the computer starts executing this statement, the computer calls a 
method named System. out.println into action. (Yes, in Java, a name can have 
dots in it. The dots mean something.) 

To find out the meaning behind the dots in Java names, see Chapter 7. 

Figure 3-5 illustrates the System . out . pri ntl n situation. Actually, two meth- 
ods play active roles in the running of the Di spl ayer program. Here's how 
they work: 




V There's a declaration for a mai n method. I wrote the main method 
myself. This main method is called automatically whenever I start run- 
ning the Di spl ayer program. 

i>* There's a call to the System, out . pri ntl n method. The method call for 
the System . out .println method is the only statement in the body of 
the mai n method. In other words, calling the System .out . pri ntl n 
method is the only thing on the ma i n method's to-do list. 

The declaration for the System .out.println method is buried inside the 
official Java API. For a refresher on the Java API, see the sections, "The 
grammar and the common names" and "The words in a Java program," 
earlier in this chapter. 



When I say things like "System . out . pri ntl n is buried inside the API," I'm 
not doing justice to the API. True, you can ignore all the nitty-gritty Java code 
inside the API. All you need to remember is that System . out .println is 
defined somewhere inside that code. But I'm not being fair when I make the 
API code sound like something magical. The API is just another bunch of Java 
code. The statements in the API that tell the computer what it means to carry 
out a call to System . out .println look a lot like the Java code in Listing 3-1. 
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In Java, each statement (like the boxed line in Figure 3-4) ends with a semi- 
colon. Other lines in Figure 3-4 don't end with semicolons, because the other 
igure 3-4 aren't statements. For instance, the method header (the 
the word main in it) doesn't directly tell the computer to do any- 
thing. The method header announces, "Just in case you ever want to do mai n, 
^jABE/? the next few lines of code tell you how you'll do it." 



coion. utr 

ipBodt® 

thins. The 



Every complete Java statement ends with a semicolon. 



Curty braces 



Long ago, or maybe not so long ago, your schoolteachers told you how useful 
outlines are. With an outline, you can organize thoughts and ideas, help people 
see forests instead of trees, and generally show that you're a member of the 
Tidy Persons Club. Well, a Java program is like an outline. The program in 
Listing 3-1 starts with a big header line that says, "Here comes a class named 
Displayer." After that first big header is a subheader that announces, "Here 
comes a method named main." 



Figure 3-5: 

Calling the 
System, out. 
println 
method. 



Somewhere 
inside the 
JavaAPI... 



101010000111000 . . 



The computer calls your main 
method automatically, then... 



Class Displayer { 

public static void main ( String args [ ] ) { 
System, out (print ln)( "You ' 11 love Java!") 



} 



} 




..a statement in your main method 
calls the System. out.println method. 



public void 


println ( String s) { 


ensureOpen ( ) ; 


textOut . 


write ( s ) ; 


textOut . 


f lushBuf f er ( ) ; 


} 
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Now, if a Java program is like an outline, why doesn't a program look like an 
outline? What takes the place of the Roman numerals, capital letters, and 
ings? The answer is twofold: 



a Java program, curly braces enclose meaningful units of code. 



V You, the programmer, can (and should) indent lines so that other pro- 
grammers can see the outline form of your code at a glance. 

In an outline, everything is subordinate to the item in Roman numeral I. In a 
Java program, everything is subordinate to the top line — the line with the 
word class in it. To indicate that everything else in the code is subordinate to 
this class line, you use curly braces. Everything else in the code goes inside 
these curly braces. (See Listing 3-4.) 



Listing 3-4: Curly Braces for a Java Class 



class Displayer { 




public static void main(String args[]) { 




System . out . pri ntl n ( "You ' 1 1 love Java!"); 




) 




} 





In an outline, some stuff is subordinate to a capital letter A item. In a Java 
program, some lines are subordinate to the method header. To indicate that 
something is subordinate to a method header, you use curly braces. (See 
Listing 3-5.) 



Listing 3-5: Curly Braces for a Java Method 



class Displayer ( 




public static void main(String 

Sy stem. out. pri ntl n ( " You'll 

} 

) 


args[]) { 

1 ove Java ! " ) ; 





In an outline, some items are at the bottom of the food chain. In the 
Di spl ayer class, the corresponding line is the line that begins with 
System .out .pri ntl n. Accordingly, this System .out . pri ntl n line goes 
inside all the other curly braces and is indented more than anything else. 




Never lose sight of the fact that a Java program is, first and foremost, an 
outline. 



If you put curly braces in the wrong places or omit curly braces where the 
braces should be, your program probably won't work at all. If your program 
works, it'll probably work incorrectly. 
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If you don't indent lines of code in an informative manner, your program will 
still work correctly, but neither you nor any other programmer will be able to 
t what you were thinking when you wrote the code. 



you're one of those visual thinkers, you could picture outlines of Java pro- 
grams in your head. One friend of mine visualizes an actual numbered outline 
morphing into a Java program. (See Figure 3-6.) Another person, who shall 
remain nameless, uses more bizarre imagery. (See Figure 3-7.) 



Figure 3-6: 

An outline 
turns into a 
Java 
program. 



I. The Dispayer class 
A. The main method 

1. Print "You'll love Java!" 



I. class Displayer 

A. public static void main(String args[]) 

1. System. out.println("You'll love Java!"); 



Class Displayer { 

public static void main (String args [ ] ) { 
System. out .println ( "You ' 11 love Java! 

} 

} 



Figure 3-7: 

A class is 
bigger than 
a method; a 

method is 
biggerthan 
a statement. 
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ther around campfires to hear the old legend about a programmer 
whose laziness got her into trouble. To maintain this programmer's 
anonymity, I call her Jane Pro. Jane worked many months to create the holy 
grail of computing — a program that thinks on its own. If completed, this pro- 
gram could work independently, learning new things without human interven- 
tion. Day after day, night after night, she labored to give the program that 
spark of creative, independent thought. 

One day, when she was almost finished with the project, she received a dis- 
turbing piece of paper mail from her health insurance company. No, the mail 
wasn't about a serious illness. It was about a routine office visit. The insur- 
ance company's claim form had a place for her date of birth, as if her date of 
birth had changed since the last time she sent in a claim. She had absent- 
mindedly scribbled 2004 as her year of birth, so the insurance company 
refused to pay the bill. 

Jane dialed the insurance company's phone number. Within twenty minutes 
she was talking to a live person. "I'm sorry," said the live person. "To resolve 
this issue you must dial a different number." Well, you can guess what hap- 
pened next. "I'm sorry. The other operator gave you the wrong number." And 
then "I'm sorry. You must call back the original phone number." 

Five months later, Jane's ear ached, but after 800 hours on the phone she had 
finally gotten a tentative promise that the insurance company would eventu- 
ally reprocess the claim. Elated as she was, she was anxious to get back to 
her computer programming project. Could she remember what all those lines 
of code were supposed to be doing? 

No, she couldn't. She stared and stared at her own work and, like a dream 
that doesn't make sense the next morning, the code was now completely 
meaningless to her. She had written a million lines of code and not one line 
was accompanied by an informative explanatory comment. She had left no 
clues to help her understand what she'd been thinking, so in frustration, she 
abandoned the whole project. 



Adding comments to your code 

Listing 3-6 has an enhanced version of this chapter's sample program. In 
addition to all the keywords, identifiers, and punctuation, Listing 3-6 has text 
that's meant for human beings to read. 
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Listing 3-6: Three Kinds of Comments 



ing 3-6 in "Java 2 For Dummies" 

right 2004 Wiley Publishing, Inc. All rights reserved. 

*/ 
/** 

* The Di spl ayer cl a 
* 

* ©author Barry Bu 

* ©version 1.6 02/2 

* ©see Java .lan 
*/ 

class Displayer { 
/** 

* Execution of the program starts at this main method. 
* 

* @param args (See Chapter 11.) 
*/ 

public static void main(String args[]) { 

System . out . pri ntl n (" I love Java!"); //Changed to "I" 

) 



A comment is a special section of text inside a program. It is text whose pur- 
pose is to help people understand the program. A comment is part of a good 
program's documentation. 

The Java programming language has three different kinds of comments: 

f* Traditional comments: The first five lines of Listing 3-6 form one traditional 
comment. The comment begins with /* and ends with */. Everything 
between the opening / * and the closing * / is for human eyes only. No 
information about "Java 2 For Dummi es " or Wi 1 ey Publishing, 
Inc. is translated by the compiler. 

To read about compilers, see Chapter 2. 

The second, third, and fourth lines in Listing 3-6 have extra asterisks (*). 
I call them extra because these asterisks aren't required when you 
create a comment. They just make the comment look pretty. I include 
them in Listing 3-6 because, for some reason that I don't entirely under- 
stand, most Java programmers add these extra asterisks. 

End-of-line comments: The text / /Changed to "I" in Listing 3-6 is an 
end-of-line comment. An end-of-line comment starts with two slashes, 
and goes to the end of a line of type. Once again, no text inside the end- 
of-line comment gets translated by the compiler. 



DropBocfo 



ss displays text on the computer screen, 
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V Javadoc comments: A javadoc comment begins with a slash and two 
asterisks (/**). Listing 3-6 has two javadoc comments — one with text 

Displayer class . . . and another with text Executi on of 
program. . . . 



A javadoc comment is a special kind of traditional comment. A javadoc 
comment is meant to be read by people who never even look at the Java 
code. But that doesn't make sense. How can you see the javadoc com- 
ments in Listing 3-6 if you never look at Listing 3-6? 

Well, a certain program called javadoc (what else?) can find all the 
javadoc comments in Listing 3-6 and turn these comments into a nice- 
looking Web page. The page is shown in Figure 3-8. 



Package E^STree Deprecated Index Help 

FRAMES NO FRAMES All Classes 
DETAIL: FIELD | CONSTft | METHOD 



Class Displayer 

1 ava . 1 ana . Ob i ec t 
I— Displayer 



PREV CLASS NEXT CLASS 

SUMMARY: NESTED I FIELD I CQNSTR I METHOD 



class Displayer 
extends Object 

The Displayer class displays text on the computer screea 
See Also: 



Figure 3-8: 

The javadoc 
page 
generated 
from the 
code in 
Listing 3-6. 



Constructor Summary 








Disulaver ( i 









Method Summary 



ni-i i ti ( : a : [ ] args ) 

Execution of the program starts at this main method 



Methods inherited from class j ava. laiig Object 



■ _ : lie , ajiuaU, - = m alize , get /lass, has.i'Io lie . 



tif vAll , toStr inc; . 



Constructor Detail 



Displayer 

Displayer ( ) 



Method Detail 



public static voici main | 3t r ing [] args) 

Execution of the program starts at this main method. 

Parameters: 

args - (See Chapter 1 1 ) 



Package BT^^ Tree Deprecated Index Help 
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Javadoc comments are great. Here are several great things about them: 



DropBoofcg 

wha' 




only person who has to look at a piece of Java code is the program- 
who writes the code. Other people who use the code can find out 
what the code does by viewing the automatically generated Web page. 

Because other people don't look at the Java code, other people don't 
make changes to the Java code. (In other words, other people don't 
introduce errors into the existing Java code.) 

Because other people don't look at the Java code, other people don't 
have to decipher the inner workings of the Java code. All these people 
need to know about the code is what they read in the code's Web page. 

The programmer doesn't create two separate things — some Java code 
over here and some documentation about the code over there. Instead, 
the programmer creates one piece of Java code and embeds the docu- 
mentation (in the form of javadoc comments) right inside the code. 

Best of all, the generation of Web pages from javadoc comments is done 
automatically. So everyone's documentation has the same format. No 
matter whose Java code you use, you find out about that code by read- 
ing a page like the one in Figure 3-8. That's good because the format in 
Figure 3-8 is familiar to anyone who uses Java. 



You can generate your own Web pages from the javadoc comments that you 
put in your code. To discover how, visit this book's Web site. 



What's Barry's excuse} 

For years, I've been telling my students to put comments in their code, and 
for years I've been creating sample code (like the code in Listing 3-1) with no 
comments in it. Why? 

Three little words: "Know your audience." When you write complicated, real- 
life code, your audience is other programmers, information technology man- 
agers, and people who need help deciphering what you've done. When I write 
simple samples of code for this book, my audience is you — the novice Java 
programmer. Instead of reading my comments, your best strategy is to stare 
at my Java statements — the statements that Java's compiler deciphers. 
That's why I put so few comments in this book's listings. 



Besides, I'm a little lazy. 



Finding jatodoc pages 

In Chapter 2, 1 encourage you to download a copy of the official Java API 
documentation. This API documentation is a huge collection of Web pages 
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created automatically from javadoc comments. To access this documenta- 
tion, do the following: 



w Steps 1 and 2 in the step list that conies immediately after 
Listing 3-1 in this chapter. 

The code of Listing 3-1 appears in JCreator's Editor pane. 

2. In the Editor pane, right-click the word System. In the resulting con- 
text menu, choose Show JDK Help. 

The javadoc page for System appears in JCreator's Editor pane. To see 
more of this page, use the pane's scrollbar. The stuff on this page may 
not make much sense to you now, but as you read more of this book, 
things become clearer. 

For tips on reading and understanding Java's API documentation, see 
this book's Web site. 

3. Click the Displayer.java tab at the top of the Editor pane. 

The code of Listing 3-1 appears once again. 

4. In the Editor pane, right-click the word println, and choose Show JDK 
Help from the context menu that appears. 

The documentation for the println method appears in the Editor pane. 



Usinq comments to experiment 
tilth your code 

You may hear programmers talk about commenting out certain parts of their 
code. When you're writing a program and something's not working correctly, 
it often helps to try removing some of the code. If nothing else, you find out 
what happens when that suspicious code is removed. Of course, you may not 
like what happens when the code is removed, so you don't want to delete the 
code completely. Instead, you turn your ordinary Java statements into com- 
ments. For instance, you turn the statement 

System . out . pri ntl n (" I love Java!"); 

into the comment 

// System . out . pri ntl n (" I love Java!"); 

This keeps the Java compiler from seeing the code while you try to figure out 
what's wrong with your program. 
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Traditional comments aren't very useful for commenting out code. The big 
problem is that you can't put one traditional comment inside of another. For 
suppose you want to comment out the following statements: 

. out . pri ntl n (" Parents ,") ; 
System . out . pri ntl n ( " pi ck your " ) ; 
/* 

* Intentionally displays on four separate lines 
*/ 

System. out. print! n ( "battl es" ) ; 
System. out. pri ntl n( "car efully !") ; 



If you try to turn this code into one traditional comment, you get the follow- 
ing mess: 



/* 




System. out .pri ntl n ( "Parents ,") ; 




System . out . pri ntl n ( "pi ck your" ) ; 




/* 




* Intentionally displays on four separate lines 




*/ 




System. out . pri ntl n ( "battl es ") ; 




System. out .pri ntl n ( "careful ly! ") ; 




*/ 





The first * / (after Intentionally displays) ends the traditional comment 
prematurely. Then the battl es and careful ly statements aren't com- 
mented out, and the last */ chokes the compiler. 



So the best way to comment out code is to use end-of-line comments. But 
typing two slashes for each of ten lines can be tedious. Fortunately, JCreator 
has a good shortcut. Here's how it works: 

1. Select the lines that you want to comment out. 

2. From the JCreator menu bar, choose EditOFormatOIncrease 
Comment Indent. 

When you do this, each selected line becomes an end-of-line comment. End- 
of-line comments can contain traditional comments (and end-of-line com- 
ments can contain other end-of-line comments) so you can comment out the 
Parents, pick your battles caret ul ly ! code with no unwanted side 
effects. If you decide later to uncomment the code, that's easy, too: 

1. Select the lines that you no longer want to be commented out. 

2. From the JCreator menu bar, choose EditOFormatODecrease 
Comment Indent. 
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; else's Java code (code that you down- 
load from this book's Web site). But eventually, you'll write code on your 
own. This section shows you how to create code with the JCreator develop- 
ment environment. 

The version of JCreator on this book's CD-ROM has a specially customized 
My Projects directory. The My Projects directory contains several ready- 
made workspaces. One of these workspaces (named MyWorkspace) has no 
projects in it. Here's how you create a project in MyWorkspace: 

1. Launch JCreator. 

2. From JCreator's menu bar, choose FileOOpen Workspace. 

An Open dialog box appears. 

3. In the Open dialog box, select MyWorkspace . jew (or simply 
MyWorkspace). Then click Open. 

Clicking Open may coax out a message box asking whether you want to 
"Save the workspace modifications?" If so, click Yes. Clicking Open may 
coax out another box asking if you want to ". . . close all document 
Windows?" If so, click Yes. 

In MyWorkspace . j cw, the extension . j cw stands for "JCreator work- 
space." 

After clicking Open, you see MyWorkspace in JCreator's File View pane. 
The next step is to create a new project within MyWorkspace. 

4. In the File View pane, right-click MyWorkspace. Then choose Add new 
Project from the context menu that appears, as shown in Figure 3-9. 

JCreator's Project Wizard opens. (See Figure 3-10.) 

5. In the wizard's Project Template tab, select the Empty Project icon, 
and then click Next. 

After clicking Next, you see the wizard's Project Paths tab, as shown in 
Figure 3-11. 
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Figure 3-9: 
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Figure 3-10: 

The Project 
Wizard's 
Project 
Template 
tab. 
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Figure 3-11: 

The Project 
Wizard's 
Project 
Paths tab. 
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6. In the Name field, type MyFirstProject. 

You can add blank spaces, making the name My First Project, but I don't 
recommend it. 

7. Make sure that the Add to Current Workspace radio button is 
selected, and then click Finish. 

If you click Next instead of Finish, you see some other options that you 
don't need right now. So to avoid any confusion, just click Finish. 

Clicking Finish brings you back to JCreator's work area, with 
MyFi rstProject set in bold. The bold typeface means that 
MyFi rst Project is the active project. The next step is to create a 
new Java source code file. 
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In the File View pane, right-click MyFi rstProject. Then choose 
AddONew Class from the context menu that appears, as shown in 
re 3-12. 



'ator's Class Wizard opens. (See Figure 3-13.) 
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Like every other windowed environment, JCreator provides many ways to 
accomplish the same task. Instead of right-clicking MyFi rstProject, you 
can go to the menu bar and choose FileONewOClass. But right-clicking 
a project has a small benefit. If you right-click the name of a project, the 
newly created class is without a doubt in that project. If you use the menu 
bar instead, the newly created class goes in whichever project happens 
to be the active project. So if your workspace contains many projects, you 
can accidentally put the new class into the wrong project. 

9. In the Class Wizard's Name field, type the name of your new class. 

For this first project, I highly recommend the name Displayer. To be safe, 
use an uppercase letter D and lowercase letters for all the other charac- 
ters. (See Figure 3-13.) 
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10. Skip everything in the Class Wizard except the Name field. (In other 
words, click Finish.) 

ing Finish brings you back to JCreator's work area. Now the Editor 
has a tab named Displayer.java. For your convenience, the 
Displayer.java tab already has a tiny bit of code in it. (See Figure 3-14.) 



Figure 3-14: 

JCreator 
writes a bit 
of code in 
the Editor 
pane. 



Displayer.java 



2 □ class Displayer { 

3, L } 
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11. Type your new Java program. 

Add your code to the code in JCreator's Editor pane. For this first project, 
I recommend copying the code in Listing 3-1 exactly as you see it. 

• Spell each word exactly the way I spell it in Listing 3-1. 

• Capitalize each word exactly the way I do in Listing 3-1. 

• Include all the punctuation symbols — the curly braces, the semi- 
colon, everything. 

12. From the menu bar, choose BuildOCompile Project. 

If you typed everything correctly, you see the comforting Process com- 
pl eted message, with no error messages, at the bottom of JCreator's 
work area. The text appears in JCreator's Build Output pane, which now 
covers up the old General Output pane. (See Figure 3-15.) 



Figure 3-15: 

The result of 
a successful 
compilation. 
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When you choose BuildOCompile Project, JCreator compiles whichever 
project is currently active. Only one project at a time is active. So if your 
workspace contains several projects, make sure that the project you 
want to compile is currently the active project. 
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13. Check for error messages at the bottom of JCreator's work area. 

If^n Step 11, you didn't type the code exactly as it's shown in Listing 3-1, 
see some error messages in the Task List pane. (Like so many other 
'gs, the Task List pane appears at the bottom of JCreator's work 
area.) 

Each error message refers to a specific place in your Java code. To jump 
the cursor to that place in the Editor pane, double-click the message in 
the Task List pane. Compare everything you see, character by character, 
with my code in Listing 3-1. Don't miss a single detail, including spelling, 
punctuation, and uppercase versus lowercase. 

14. Make any changes or corrections to the code in the Editor pane. Then 
repeat Steps 12 and 13. 

When at last you see the Process compl eted message with no error 
messages, you're ready to run the program. 

15. From the menu bar choose BuildOExecute Project. 

That does the trick. Your new Java program runs in JCreator's General 
Output pane. If you're running the code in Listing 3-1, you see the 
You'll love Java! message in Figure 3-1 . And believe me; messages 
like this are never wrong. 
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In this part . . . 

;n this part, you dig in and get dirty by writing some 
programs and finding out what Java really feels like. 
Some of the stuff in this part is specific to Java, but lots of 
the material is just plain old generic computer program- 
ming. Here you concentrate on details — details about 
data, logic, and program flow. After you've read this part 
and practiced some of the techniques, you can write all 
kinds of interesting Java programs. 



Chapter 4 

WaKmg the Most of Variables 
and Their Values 



In This Chapter 

Assigning values to things 

Making things store certain types of values 

Applying operators to get new values 



T, 



he following conversation between Van Doren and Philbin never took 
place: 

Charles: A sea squirt eats its brain, turning itself from an animal into a 
plant. 

Regis: Is that your final answer, Charles? 
Charles: Yes, it is. 

Regis: How much money do you have in your account today, Charles? 

Charles: I have fifty dollars and twenty-two cents in my checking account. 

Regis: Well, you better call the IRS, because I'm putting another million 
dollars in your account. What do you think of that, Charles? 

Charles: I owe it all to honesty, diligence, and hard work, Regis. 

Some aspects of this dialogue can be represented in Java by a few lines of 
code. 



Varying a Variable 



No matter how you acquire your million dollars, you can use a variable to 
tally your wealth. The code is shown in Listing 4-1. 
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ountlnAccount = 50.22; 

InAccount = amountlnAccount + 1000000.00; 



The code in Listing 4-1 makes use of the amountlnAccount variable. A vari- 
able is a placeholder. You can stick a number like 50.22 into a variable. After 
you place a number in the variable, you can change your mind and put a dif- 
ferent number into the variable. (That's what varies in a variable.) Of course, 
when you put a new number in a variable, the old number is no longer there. 
If you didn't save the old number somewhere else, the old number is gone. 

Figure 4-1 gives a before-and-after picture of the code in Listing 4-1. After the 
first statement in Listing 4-1 is executed, the variable amountlnAccount has 
the number 50.22 in it. Then, after the second statement of Listing 4-1 is exe- 
cuted, the amountl nAccount variable suddenly has 1000050.22 in it. When 
you think about a variable, picture a place in the computer's memory where 
wires and transistors store 50.22, 1000050.22, or whatever. In the left side of 
Figure 4-1, imagine that the box with the number 50.22 in it is surrounded by 
millions of other such boxes. 



Before executing 
amountlnAccount = 

amountlnAccount + 1000000.00; 



After executing 
amountlnAccount = 

amountlnAccount + 1000000.00; 



Figure 4-1: 

A variable 
(before and 
after). 



amountlnAccount 



50.22 



amountlnAccount 



1000050.22 



Now you need some terminology. The thing stored in a variable is called a 
value. A variable's value can change during the run of a program (when Regis 
gives you a million bucks, for instance). The value that's stored in a variable 
isn't necessarily a number. (You can, for instance, create a variable that 
always stores a letter.) The kind of value that's stored in a variable is a vari- 
able's type. 

You can read more about types in the section "Understanding the Types of 
Values That Variables May Have," later in this chapter. 
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A subtle, almost unnoticeable difference exists between a variable and a vari- 
able's name. Even in formal writing, I often use the word variable when I mean 
\i&bJwiame. Strictly speaking, amountlnAccount is a variable name, and 
smory storage associated with amountlnAccount (including the 
type that amountlnAccount has and whatever value amountlnAccount 
currently represents) is the variable itself. If you think this distinction 
between variable and variable name is too subtle for you to worry about, 
join the club. 




Every variable name is an identifier — a name that you can make up in your 
own code. In preparing Listing 4-1, 1 made up the name amountlnAccount. 

For more information on the kinds of names in a Java program, see Chapter 3. 

Before the sun sets on Listing 4-1, you need to notice one more part of the 
listing. The listing has 50 . 22 and 1000000 . 00 in it. Anybody in his or her 
right mind would call these things numbers, but in a Java program it helps to 
call these things literals. 




And what's so literal about 50.22 and 1000000. 00? Well, think about the 
variable amountlnAccount in Listing 4-1. The variable amountlnAccount 
stands for 50.22 some of the time, but it stands for 1000050.22 the rest of the 
time. You could sort of use the word number to talk about amountlnAccount. 
But really, what amountlnAccount stands for depends on the fashion of the 
moment. On the other hand, 50.22 literally stands for the value 50%o. 

A variable's value changes; a literal's value doesn't. 



Assignment Statements 



Statements like the ones in Listing 4-1 are called assignment statements. In an 
assignment statement, you assign a value to something. In many cases, this 
something is a variable. 



I recommend getting into the habit of reading assignment statements from 
right to left. For instance, the first line in Listing 4-1 says, 





"Assign 50.22. . . 


amountlnAccount 


50.22; 


... to the 




amountlnAccount 




vari abl e ." 
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The second line in Listing 4-1 is just a bit more complicated. Reading the 
second line from right to left, you get 



"Add 1000000.00 to the value that's 
already in the amountlnAccount 
variabl e. . . 

amountlnAccount + 1000000.00; 



amountlnAccount 

. . . and make 

that number 

(1000050.22) be 

the new value of the 

amountlnAccount variable." 

In an assignment statement, the thing being assigned a value is always on the 
left side of the equal sign. 



Understanding the Types of Values 
That Variables May HaVe 

Have you seen the TV commercials that make you think you're flying around 
among the circuits inside a computer? Pretty cool, eh? These commercials 
show 0s (zeros) and Is sailing by because 0s and Is are the only things that 
computers can really deal with. When you think a computer is storing the 
letter J, the computer is really storing 01001010. Everything inside the com- 
puter is a sequence of 0s and Is. As every computer geek knows, a 0 or 1 is 
called a bit. 



As it turns out, the sequence 01001010, which stands for the letter J, can 
also stand for the number 74. The same sequence can also stand for 
1.0369608636003646 x 10" 43 . In fact, if the bits are interpreted as screen pixels, 
the same sequence can be used to represent the dots shown in Figure 4-2. 
The meaning of 01001010 depends on the way the software interprets this 
sequence of 0s and Is. 



Figure 4-2: 

An extreme 
close-up of 
eight black- 
and-white 
screen 
pixels. 
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So how do you tell the computer what 01001010 stands for? The answer is in 
the concept of type. The type of a variable is the range of values that the vari- 
rmitted to store. 



copied the lines from Listing 4-1 and put them into a complete Java pro- 
gram. The program is in Listing 4-2. When I run the program in Listing 4-2, 
I get the output shown in Figure 4-3. 



Listing 4-2: A Program Uses amountlnAccount 

import static Java . 1 ang . System . out ; 

class Millionaire { 

public static void main(String args[]) { 
double amountlnAccount; 

amountlnAccount = 50.22; 

amountlnAccount = amountlnAccount + 1000000.00; 

out . pri nt( "You have $"); 
out. print (amountlnAccount); 
out . pri ntl n ( " in your account."); 




Figure 4-3: 

Running the 
program in 
Listing 4-2. 



General Output 



You have 51000050 22 in your account. 
Process completed. 



-Configuration: Listing0402 - j 2sdkl . 5 . 0 <Default> 



<Default> 



In Listing 4-2, look at the first line in the body of the main method. 

double amountlnAccount; 

This line is called a variable declaration. Putting this line in your program 
is like saying, "I'm declaring my intention to have a variable named 
amountlnAccount in my program." This line reserves the name 
amountlnAccount for your use in the program. 

In this variable declaration, the word double is a Java keyword. This word 
double tells the computer what kinds of values you intend to store in 
amountlnAccount. In particular, the word double stands for numbers 
between -1.8 x 10 308 and 1.8 x 10 308 . (These are enormous numbers with 308 
zeros before the decimal point. Only the world's richest people write checks 
with 308 zeros in them. The second of these numbers is one-point-eight 
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International Bureau of Weights and Measures, is the number of eccentric 
X programmers between Sunnyvale, California, and the M31 
da Galaxy.) 



More important than the humongous range of the double keyword's numbers 
is the fact that a doubl e value can have digits beyond the decimal point. 
After you declare amountl nAccount to be of type doubl e, you can store all 
sorts of numbers in amountl nAccount. You can store 50.22, 0.02398479, or 
-3.0. In Listing 4-2, if I hadn't declared amountl nAccount to be of type 
doubl e, I may not have been able to store 50.22. Instead, I would have had to 
store plain old 50, without any digits beyond the decimal point. 



Digits beyond the decimal point 



Java has two different types that have digits 
beyond the decimal point: type double and 
type f 1 oat. So what's the difference? When 
you declare a variable to be of type double, 
you're telling the computer to keep track of 64 
bits when it stores the variable's values. When 
you declare a variable to be of type f 1 oat, the 
computer keeps track of only 32 bits. 

You could change Listing 4-2 and declare 
amountlnAccounttobe of type f 1 oat. 

float amountlnAccount ; 

Surely, 32 bits are enough to store a small 
number like 50.22. Well, they are and they aren't. 
You could easily store 50.00 with only 32 bits. 
Heck, you could store 50.00 with only 6 bits. The 
size of the number doesn't matter. It'sthe accu- 
racy that matters. In a 64-bit double variable, 
you're using most of the bits to store stuff 
beyond the decimal point. To store the .22 part 
of 50.22, you need more than the measly 32 bits 
that you get with type f 1 oat. 

Do you really believe what you just read — that 
it takes more than 32 bits to store .22? To help 
convinceyou, I made afewchangestothe code 
in Listing 4-2. 1 made amountlnAccount be of 
type float, and the output I got was 

You have $1000050.25 in your 
account . 



Compare this with the output in Figure 4-3. 
When I switch from type double to type 
float, Charles has an extra three cents in 
his account. By changing to the 32-bit f 1 oat 
type, I've clobbered the accuracy in the 
amountlnAccount variable's hundredths 
place. That's bad. 

Another difficulty with f 1 oat values is purely 
cosmetic. Look again at the literals, 50.22 
and 1000000.00, in Listing 4-2. The Laws 
of Java say that literals like these take up 
64 bits each. This means that if you declare 
amountlnAccount to be of type float, 
you're going to run into trouble. You'll have 
trouble stuffing those 64-bit literals into your 
little 32-bit amountlnAccount variable. To 
compensate, you can switch from double lit- 
erals to f 1 oat literals by adding an F to each 
double literal, but a number with an extra F at 
the end looks funny. 

float amountlnAccount; 

amountlnAccount = 50.22F; 
amountlnAccount = 
amountlnAccount + 
1000000. OOF; 

To experiment with numbers, visit http : // 
babbage.cs.qc.edu/courses/cs341/ 
IEEE-754. html. The page takes any number 
that you enter and shows you how the number 
would be represented as 32 bits and as 64 bits. 
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Another type — type float — also allows you to have numbers after the dec- 
imal point, but this type isn't as accurate. (See the sidebar, "Digits beyond 

al point," for the full story.) Don't sweat the choice between float 
1 e. For most programs, just use doubl e. 



Art Impart Declaration 

It's always good to announce your intentions up front. Consider the following 
classroom lecture: 

"Today, in our History of Film course, we'll be discussing the career of actor 
Lionel Herbert Blythe Barrymore. 

"Born in Philadelphia, Barrymore appeared in more than 200 films, 
including It's a Wonderful Life, Key Largo, and Dr. Kildare's Wedding Day 
In addition, Barrymore was a writer, composer, and director. Barrymore 
did the voice of Ebenezer Scrooge every year on radio. ..." 

Interesting stuff, heh? Now compare the paragraphs above with a lecture in 
which the instructor doesn't begin by introducing the subject: 

"Welcome once again to the History of Film. 

"Born in Philadelphia, Lionel Barrymore appeared in more than 200 
films, including It's a Wonderful Life, Key Largo, and Dr. Kildare's Wedding 
Day In addition, Barrymore (not Ethel, John, or Drew) was a writer, 
composer, and director. Lionel Barrymore did the voice of Ebenezer 
Scrooge every year on radio. ..." 

Without a proper introduction, a speaker may have to remind you constantly 
that the discussion is about Lionel Barrymore and not about some other 
Barrymore. The same is true in a Java program. Compare some code from 
Listings 3-1 and 4-2. From Listing 3-1: 

class Displayer { 

System. out . pri ntl n( "You ' 1 1 love Java!"); 

and from Listing 4-2: 

import static java.l ang. System. out; 

class Millionaire I 

out.print( "You have $"); 

out.print(amountlnAccount); 

out. pri ntl n( " in your account."); 
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With Listing 4-2, you announce in your introduction (in your import declara- 
tion) that you're using System . out in your Java class. You clarify what you 
System with the full name Java . 1 ang . System. (Hey! Didn't the first 
larify with the full name "Lionel Herbert Blythe Barrymore?") After 
having announced your intentions in the import declaration, you can use the 
abbreviated name out in your Java class code. 



The details of this import stuff can be pretty nasty. So for now, just paste the 
import declaration in Listing 4-2 at the top of your Java programs. (Don't 
bother pasting this import declaration into a program that doesn't use 
System .out. It probably wouldn't hurt anything, but it would look very 
strange to a veteran Java programmer.) 

No single section in this book can present the entire story about import dec- 
larations. To begin untangling some of the import declaration's subtleties, see 
Chapters 5, 9, and 10. 



Displaying Text 

The last three statements in Listing 4-2 use a neat formatting trick. You want 
to display several different things on a single line on the screen. You put 
these things in separate statements. All but the last of the statements are 
calls to out . print. (The last statement is a call to out . pri ntl n.) Calls to 
out . pri nt display text on part of a line and then leave the cursor at the end 
of the current line. After executing out . pri nt, the cursor is still at the end of 
the same line, so the next out .whatever can continue printing on that same 
line. With several calls to print capped off by a single call to pri ntl n, the 
result is just one nice-looking line of output. (Refer to Figure 4-3.) 




A call to out . pri nt writes some things and leaves the cursor sitting at the 
end of the line of output. A call to out . pri ntl n writes things and then fin- 
ishes the job by moving the cursor to the start of a brand new line of output. 



Numbers without Decimal Points 

"In 1995, the average family had 2.3 children." 

At this point, a wise guy always remarks that no real family has exactly 2.3 
children. Clearly, whole numbers have a role in this world. So, in Java, you 
can declare a variable to store nothing but whole numbers. Listing 4-3 shows 
a program that uses whole number variables. 



Chapter 4: Making the Most of Variables and Their Values 



79 



Listing 4-3: Using the int Type 



DropBooIs 



ipRP-Li static ja va . 1 ang . System . out ; 
fel evatorFi tter { 



public static void main(String args[]) I 
int wei ghtOf APerson ; 
int elevatorWeightLimit; 
int numberOf Peopl e ; 

wei ghtOf APerson = 150; 
elevatorWeightLimit = 1400; 
numberOf Peopl e = 

elevatorWeightLimit / wei ghtOf APerson ; 



out . pri nt( "You can fit "); 
out.print(numberOfPeople) ; 
out . pri ntl n ( " people on the elevator."); 




The story behind the program in Listing 4-3 takes some heavy-duty explain- 
ing. So here goes: 

You have a hotel elevator whose weight capacity is 1,400 pounds. One week- 
end, the hotel hosts the Brickenchicker family reunion. In a certain branch of 
the Brickenchicker family are identical dectuplets (ten siblings, all with the 
same physical characteristics). Normally, each of the Brickenchicker dectu- 
plets weighs exactly 145 pounds. But on Saturday, the family has a big 
catered lunch, and, because lunch included strawberry shortcake, each of 
the Brickenchicker dectuplets now weighs 150 pounds. Immediately after 
lunch, all ten of the Brickenchicker dectuplets arrive at the elevator at 
exactly the same time. (Why not? All ten of them think alike.) So, the question 
is, how many of the dectuplets can fit on the elevator? 

Now remember, if you put one ounce more than 1,400 pounds of weight on 
the elevator, the elevator cable breaks, plunging all dectuplets on the eleva- 
tor to their sudden (and costly) deaths. 

The answer to the Brickenchicker riddle (the output of the program of 
Listing 4-3) is shown in Figure 4-4. 



Figure 4-4: 

Save the 
Bricken- 
chickers! 



General Output 



You can fit 9 people on the elevator 
process romp I e t ed 



-Configuration: Listing0403 - j2sdkl.5.0 <Default> - <Default>- 
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The types are called byte, short, i nt, and 
long. Unlike the complicated story about the 
accuracy oftypes f 1 oat and doubl e,the only 
thing that matters when you choose among the 
whole number types is the size of the number 
that you're trying to store. If you want to use 
numbers larger than 127, don't use byte. To 



ur ways to store whole numbers 



store numbers larger than 32767, don't use 

short. 

Most of the time, you'll use i nt. But if you need 
to store numbers larger than 2147483647, 
forsake i nt in favor of 1 ong. (A long number 
can be as big as 9223372036854775807.) For the 
whole story, see Table 4-1. 



At the core of the Brickenchicker elevator problem, you've got whole 
numbers — numbers with no digits beyond the decimal point. When you 
divide 1,400 by 150, you get 9X, but you shouldn't take the X seriously. No 
matter how hard you try, you can't squeeze an extra 50 pounds worth of 
Brickenchicker dectuplet onto the elevator. This fact is reflected nicely in 
Java. In Listing 4-3, all three variables (wei ghtOf APerson, 
el evatorWei ght Li mi t, and numberOfPeople) are of type i nt. An i nt value 
is a whole number. When you divide one i nt value by another (as you do 
with the slash in Listing 4-3), you get another int. When you divide 1,400 by 
150, you get 9 — not 9X. You see this in Figure 4-4. Taken together, the follow- 
ing statements put the number 9 on the computer screen: 

numberOfPeople = 

el evatorWei ghtLi mi t / wei ghtOf APerson ; 

out.print(numberOfPeople); 



Combining Declarations and 
Initializing Variables 

Look back at Listing 4-3. In that listing, you see three variable declarations — 
one for each of the program's three i nt variables. I could have done the 
same thing with just one declaration: 

int wei ghtOf APerson , el evatorWei ghtLi mi t , numberOfPeople; 

If two variables have completely different types, you can't create both vari- 
ables in the same declaration. For instance, to create an int variable named 
weightOfFred and a doubl e variable named amountlnFredsAccount, you need 
two separate variable declarations. 
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You can give variables their starting values in a declaration. In Listing 4-3 
for instance, one declaration can replace several lines in the main method 
e calls to print and p r i n 1 1 n). 

ghtOfAPerson = 150, el evatorWei ghtLimi t = 1400, 
numberOf Peopl e = el evatorWei ghtLi mi t / wei ghtOfAPerson ; 

When you do this, you don't say that you're assigning values to variables. 
The pieces of the declarations with equal signs in them aren't really called 
assignment statements. Instead, you say that you're initializing the variables. 
Believe it or not, keeping this distinction in mind is helpful. 

Like everything else in life, initializing a variable has advantages and 
disadvantages: 

When you combine six lines of Listing 4-3 into just one declaration, 
the code becomes more concise. Sometimes, concise code is easier to 
read. Sometimes it's not. As a programmer, it's your judgment call. 

i>* By initializing a variable, you may automatically avoid certain 
programming errors. For an example, see Chapter 7. 

i>* In some situations, you have no choice. The nature of your code 
forces you either to initialize or not to initialize. For an interesting 
example, see the deleting-evidence program in Chapter 6. 

Atoms: Java's Primitive Types 

The words int and double, which I describe in the previous sections, are 
examples of primitive types (also known as simple types) in Java. The Java 
language has exactly eight primitive types. As a newcomer to Java, you can 
pretty much ignore all but four of these types. (As programming languages 
go, Java is nice and compact that way.) The complete list of primitive types is 
shown in Table 4-1. 



Table 4-1 


Java's Primitive Types 


Type Name 


What a Literal Looks Like Range of Values 


Whole number types 


byte 


(byte) 42 -128 to 127 


short 


_(short)42 -32768 to 32767 


i nt 


42 -21 47483648 to 

2147483647 



(continued) 
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Table 4-1 (continued) 


\ \j/p^iame 


What a Literal Looks Like 


Range of Values 


7l\o 

1 ong 


42L 


-9223372036854775808 to 
9223372036854775807 


Decimal number types 


float 


42. OF 


-3.4x 10 38 to 3.4 x10 38 


double 


42.0 


-1.8 x 10 308 to1 


,8 x 10 308 


Character type 


char 


'A' 


Thousands of characters, 
glyphs, and symbols 


Logical type 




bool ean 


true 


true, false 





The types that you shouldn't ignore are i nt, doubl e, char, and bool ean. 
Previous sections in this chapter cover the i nt and double types. So, this 
section covers char and bool ean types. 



The char type 

Not so long ago, people thought computers existed only for doing big number- 
crunching calculations. Nowadays, with word processors, nobody thinks that 
way anymore. So, if you haven't been in a cryogenic freezing chamber for the 
last 20 years, you know that computers store letters, punctuation symbols, 
and other characters. 

The Java type that's used to store characters is called char. Listing 4-4 has 
a simple program that uses the char type. The output of the program of 
Listing 4-4 is shown in Figure 4-5. 




Listing 4-4: Using the char Type 

class CharDemo I 

public static void main(String args[]) I 
char myLittl eChar = 'b'; 

char myBigChar = Character. toUpperCase(myLittleChar) ; 
System.out.println(myBigChar); 

) 

) 
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Figure 4-5: 
oJxb 




program of 
Listing 4-4. 



-Configuration: Iisting04[J4 - j 2sdkl . S . 0 <De£ault> - <Dofault> 



Process completed. 




if " 





In Listing 4-4, the first initialization stores the letter b in the variable 

my Li ttl eChar. In the initialization, notice how b is surrounded by single 

quote marks. In Java, every char literal starts and ends with a single quote 

mark. 

In a Java program, single quote marks surround the letter in a c h a r literal. 

If you need help sorting out the terms assignment, declaration, and initializa- 
tion, see the "Combining Declarations and Initializing Variables" section, 
earlier in this chapter. 

In the second initialization of Listing 4-4, the program calls an API method 
whose name is Character. toUpperCase. The Character. toUpperCase method 
does just what its name suggests — the method produces the uppercase 
equivalent of the letter b. This uppercase equivalent (the letter E) is assigned 
to the my B i g C h a r variable, and the B that's in my B i g C h a r is printed on the 
screen. 

For an introduction to the Java Application Programming Interface (API), see 
Chapter 3. 

If you're tempted to write the following statement, 

char myLittl eChars = 'barry'; //Don't do this 

please resist the temptation. You can't store more than one letter at a time in 
a char variable, and you can't put more than one letter between a pair of 
single quotes. If you're trying to store words or sentences (not just single 
letters), you need to use something called a String. 

For a look at Java's String type, see the section, "The Molecules and 
Compounds: Reference Types," later in this chapter. 

If you're used to writing programs in other languages, you may be aware of 
something called ASCII Character Encoding. Most languages use ASCII; Java 
uses Unicode. In the old ASCII representation, each character takes up only 
8 bits, but in Unicode, each character takes up 16 bits. Whereas ASCII stores 
the letters of the familiar Roman (English) alphabet, Unicode has room for 
characters from all the world's languages. The only problem is that some of 
the API methods are geared specially toward the 16-bit code. Occasionally, 
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this bites you in the back. If you're using a method to write Hel 1 o on the 
screen and Hello shows up instead, check the method's documentation 
on of Unicode characters. 



It's worth noticing that the two methods, Character . toUpperCase and 
System .out . pri ntl n, are used quite differently in Listing 4-4. The method 
Character. toUpperCase is called as part of an initialization or an assign- 
ment statement, but the method System . out . pri ntl n is called on its own. 
To find out more about this, see Chapter 7. 



The boolean type 

A variable of type boolean stores one of two values — true or false. 
Listing 4-5 demonstrates the use ofaboolean variable. The output of the 
program in Listing 4-5 is shown in Figure 4-6. 



Listing 4-5: Using the boolean Type 

import static Java . 1 ang . System. out ; 

class El evatorFi tter2 { 

public static void main(String args[]) { 
out . pri ntl n ( "True or False?"); 
out . pri ntl n ( "You can fit all ten of the"); 
out.println("Brickenchicker dectuplets"); 
out . pri ntl n ( "on the elevator:"); 
out . pri ntl n ( ) ; 

int wei ghtOf APerson = 150; 

int elevatorWeightLimit = 1400; 

int numberOf Peopl e = 

elevatorWeightLimit / wei ghtOf APerson ; 

boolean allTenOkay = numberOf Peopl e >= 10; 

out.println(allTenOkay); 

) 

) 



Figure 4-6: 

The 
Bricken- 
chicker 
dectuplets 
strike again. 



General Output 



True or False? 
You can fit all ten of the 
Brickenchicker dectuplets 
on the elevator: 



-Configuration: ListingCUOS - j 2sdkl . 5 . 0 <Default> 



f alse 
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In Listing 4-5, the al 1 Ten Okay variable is of type bool ean. To find a value for 
the al 1 TenOkay variable, the program checks to see whether numberOf Peopl e 
than or equal to ten. (The symbols >= stand for greater than or 



At this point, becoming fussy about terminology pays. Any part of a Java 
program that has a value is called an expression. If you write 

wei ghtOf APerson = 150; 



then 150 is an expression (an expression whose value is the quantity 150). 
If you write 



numberOf Eggs 



2 + 2; 



then 2 + 2 is an expression (because 2 + 2 has the value 4). If you write 

int numberOf Peopl e = 

el evatorWei ghtLi mi t / wei ghtOf APerson ; 

then el evatorWei ghtLimit / wei ghtOf APerson is an expression. (The 
value of the expression el evatorWeightLimit / wei ghtOf APerson 
depends on whatever values the variables elevatorWei ghtLimit and 
^tABEyj wei ghtOf APerson have when the code containing the expression is executed.) 

Any part of a Java program that has a value is called an expression. 

In Listing 4-5, the code numberOf Peopl e >= 10 is an expression. The expres- 
sion's value depends on the value stored in the numberOf Peopl e variable. 
But, as you know from seeing the strawberry shortcake at the Brickenchicker 
family's catered lunch, the value of numberOfPeople isn't greater than or 
equal to ten. This makes the value of numberOf Peopl e >= 10 to be false. 
So, in the statement in Listing 4-5, in which a 1 1 TenOkay is assigned a value, 
theallTenOkay variable is assigned a f a 1 s e value. 



In Listing 4-5, 1 call out . pri ntl n ( ) with nothing inside the parentheses. 
When I do this, Java adds a line break to the program's output. In Listing 4-5, 
out.printlnO tells the program to display a blank line. 



The Molecules and Compounds: 
Reference Types 

By combining simple things, you get more complicated things. That's the way 
it always goes. Take some of Java's primitive types, whip them together to 
make a primitive type stew, and what do you get? A more complicated type 
called a reference type. 
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The program in Listing 4-6 uses reference types. Figure 4-7 shows you what 
happens when you run the program in Listing 4-6. 



-6: Using Reference Types 



import j avax . swi ng . J Frame ; 
class ShowAFrame { 



publ i c stati c void 
JFrame myFrame 
String myTitle 



main(String args[] ) I 
= new JFrame( ) ; 
= "Blank Frame"; 



myFrame . setTi tl e (myTi tie); 
myFrame. setSize(200, 200); 
myFrame . setDef aul tCl oseOperati on 

(JFrame. EXIT_0N_CL0SE ) ; 
myFrame.setVisible(true); 




Figure 4-7: 

An empty 
frame. 




The program in Listing 4-6 uses two references types. Both of these types are 
defined in the Java API. One of the types (the one that you'll use all the time) 
is called String. The other type (the one that you can use to create GUIs) is 
called JFrame. 



A Stri ng is a bunch of characters. It's like having several char values in a 
row. So, with the myTi tl e variable declared to be of type String, assigning 
"Blank F r a me " to the my T i 1 1 e variable makes sense in Listing 4-6. The 
String class is declared in the Java API. 

In a Java program, double quote marks surround the letters in a Stri ng literal. 



A Java JFrame is a lot like a window. (The only difference is that you call it a 
JFrame instead of a window.) To keep Listing 4-6 short and sweet, I decided 
not to put anything in my frame — no buttons, no fields, nothing. 
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Even with a completely empty frame, Listing 4-6 uses tricks that I don't 
describe until later in this book. So don't try reading and interpreting every 
isting 4-6. The big thing to get from Listing 4-6 is that the program 
ariable declarations. In writing the program, I made up two variable 
"names — myTi tl e and my Frame. According to the declarations, myTi tl e is of 
type Stri ng, and my Frame is of type J Frame. 



You can look up Stri ng and J Frame in Java's API documentation. But, even 
before you do, I can tell you what you'll find. You'll find that String and 
J Frame are the names of Java classes. So, that's the big news. Every class is 
the name of a reference type. You can reserve amountlnAccount for double 
values by writing 



double amountlnAccount; 



or by writing 



double amountlnAccount = 50.22; 



You can also reserve my Frame for a J Frame value by writing 



JFrame myFrame; 



or by writing 




JFrame myFrame = new JFrameO; 

To review the notion of a Java class, see the sections on object-oriented 
programming (OOP) in Chapter 1. 

Every Java class is a reference type. If you declare a variable to have some 
type that's not a primitive type, the variable's type is (most of the time) the 
name of a Java class. 



Now, when you declare a variable to have type i nt, you can visualize what 
that declaration means in a fairly straightforward way It means that, some- 
where inside the computer's memory, a storage location is reserved for that 
variable's value. In that storage location is a bunch of bits. The arrangement 
of the bits assures that a certain whole number is represented. 

That explanation is fine for primitive types like i nt or doubl e, but what does 
it mean when you declare a variable to have a reference type? What does it 
mean to declare variable myFrame to be of type JFrame? 

Well, what does it mean to declare /' thank You God to be an E. E. Cummings 
poem? What would it mean to write the following declaration? 



EECummi ngsPoem i thankYouGod ; 
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It means that a class of things is EECummi ngsPoem, and i thankYouGod refers 
to an instance of that class. In other words, i thankYouGod is an object 
to the EECummingsPoem class. 



Frame is a class, you can create objects from that class. (See 
Chapter 1.) Each such object (each instance of the J Frame class) is an actual 
frame — a window that appears on the screen when you run the code in 
Listing 4-6. By declaring the variable my Frame to be of type J Frame, you're 
reserving the use of the name my Frame. This reservation tells the computer 
that my Frame can refer to an actual J Frame-type object. In other words, 
my Frame can become a nickname for one of the windows that appears on the 
computer screen. The situation is illustrated in Figure 4-8. 



The JFrame class 



Figure 4-8: 

The variable 
myFrame 
refers to an 
instance of 
the JFrame 
class. 




myFrame 



lx 








An object 
(an instance of 
the JFrame class) 



Another object 
(another instance of 
the JFrame class) 



When you declare CI assName vari abl eName ;, you're saying that a certain 
variable can refer to an instance of a particular class. 

In Listing 4-6, the phrase JFrame myFrame reserves the use of the name 
my Frame. On that same line of code, the phrase new J Frame () creates a new 
object (an instance of the J Frame class). Finally, that line's equal sign makes 
myFrame refer to the new object. Knowing that the two words new J Frame( ) 
create an object can be very important. For a more thorough explanation of 
objects, see Chapter 7. 
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Primitive type stew 



iil^TiTrDnftflte^frbject of frames, what's a 
frame anyway? A frame is a window that has a 
certain height and width and a certain location 
on your computer's screen. So, deep inside the 
declaration of the Frame class, you can find 
variable declarations that look something like 
this: 

int width; 
int height; 
int x; 

int y; 

Here's another example — Ti me. An instance 
of the Ti me class may have an hour (a number 
from 1 to 1 2), a number of minutes (from 0 to 59), 
and a letter (afor a.m.; pfor p.m.). 



int hour; 
int minutes; 
char amOrPm; 

So notice that this high and mighty thing called 
a Java API class is neither high nor mighty. 
A class isjusta collection of declarations. Some 
of those declarations are the declarations of 
variables. Some of those variable declarations 
use primitive types, and other variable declara- 
tions use reference types. These reference 
types, however, come from other classes, and 
the declarations of those classes have vari- 
ables. The chain goes on and on. Ultimately, 
everything comes, in one way or another, from 
the primitive types. 



Creating Neu) Values by 
Applying Operators 

What could be more comforting than your old friend, the plus sign? It was the 
first thing that you learned about in elementary school math. Almost every- 
body knows how to add 2 and 2. In fact, in English usage, adding 2 and 2 is a 
metaphor for something that's easy to do. Whenever you see a plus sign, a 
cell in your brain says, "Thank goodness — it could be something much more 
complicated." 

So Java has a plus sign. You can use it for several different purposes. You can 
use the plus sign to add two numbers, like this: 

int apples, oranges, fruit; 

apples = 5; 

oranges = 16; 

fruit = apples + oranges; 

You can also use the plus sign to paste Stri ng values together: 

String startOfChapter = 

"It's three in the morning. I'm dreaming about the "+ 
"history course that I failed in high school."; 

Sy stem. out. println(startOfChapter); 
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This can be handy because in Java, you're not allowed to make aString 
straddle from one line to another. In other words, the following code wouldn't 
11: 



g thisIsBadCode = 
"It's three in the morning. I'm dreaming about the 
history course that I failed in high school."; 
System . out . pri ntl n ( thi si sBadCode ) ; 



,^/^^v5 \ The correct way to say that you're pasting String values together is to say 
that you're concatenating String values. 

You can even use the plus sign to paste numbers next to Stri ng values. 



int apples, oranges, fruit; 
apples = 5; 
oranges = 16; 
fruit = apples + oranges; 
System . out . pri ntl n ( "You have " + fri 
" pieces of frui'1 


n't + 

: . " ) ; 




Of course, the old minus sign is available too 


(but not for Stri ng 


values). 


apples = fruit - 


oranges ; 








Use an asterisk (*) fc 


ir multiplication and a forward slash (/) for division. 


double rate, pay; 
int hours; 

rate = 6.25; 

hours = 35; 

pay = rate * hours; 

System . out . pri ntl n ( pay ) ; 









For an example using division, refer to Listing 4-3. 

^j\\NG/ When you divide an int value by another i n t value, you get an int value. 
^/ ^<j^\ The computer doesn't round. Instead, the computer chops off any remainder. 

If you put System . out . pri ntl n ( 1 1 / 4 ) in your program, the computer 
prints 2, not 2 . 75. To get past this, make either (or both) of the numbers 
you're dividing doubl e values. If you put System . out . pri ntl n ( 1 1 . 0 / 4 ) 
in your program, the computer prints 2.75. 

Another useful arithmetic operator is called the remainder operator. The 
symbol for the remainder operator is the percent sign {%). When you put 
System . out . pri ntl n ( 1 1 % 4 ) in your program, the computer prints 3. It 
does this because 4 goes into 1 1 who-cares-how-many times with a remainder 
of 3. The remainder operator turns out to be fairly useful. Listing 4-7 has an 
example. 
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ipRP-Li static ja va . 1 ang . System . out ; 
akeChange I 



public static void mairHString args[]) 
int total = 248; 
int quarters = total / 25; 
int whatsLeft = total % 25; 

int dimes = whatsLeft / 10; 
whatsLeft = whatsLeft % 10; 



int nickels = whatsLeft / 5; 
whatsLeft = whatsLeft % 5; 



int cents = whatsLeft; 



out . pri ntl n (" From " + total + " cents you get"); 
out . pri ntl n ( quarters + " quarters"); 
out . pri ntl n ( dimes + " dimes"); 
out . pri ntl n ( ni ckel s + " nickels"); 
out . pri ntl n ( cents + " cents"); 

) 

} 



A run of the code in Listing 4-7 is shown in Figure 4-9. You start with a total of 
248 cents. Then 



quarters = total / 25 



divides 248 by 25, giving 9. That means you can make 9 quarters from 248 
cents. Next, 



whatsLeft = total % 25 



divides 248 by 25 again, and puts only the remainder, 23, into whatsLeft. 
Now you're ready for the next step, which is to take as many dimes as you 
can out of 23 cents. 



Figure 4-9: 

Change 
for $2.48. 



9 


quarters 


i 


2 


dimes 




0 


nickels 




3 


cents 


L 
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1 1^ |*^ j*^^^ nas tnree ' ines tnat P ut va ' ues into the variable whatsLeft: 




int whatsLeft = total % 25; 
whatsLeft = whatsLeft % 10; 
whatsLeft = whatsLeft % 5; 

Only one of these lines is a declaration. The other two lines are assignment 
statements. That's good because you can't declare the same variable more 
than once (not without creating something called a block). If you goof and 
write 



int whatsLeft 
int whatsLeft 



total % 25; 
whatsLeft % 10; 



in Listing 4-7, you see an error message (whats Left is already defined) 
when you try to compile your code. 

To find out what a block is, see Chapter 5. Then, for some honest talk about 
redeclaring variables, see Chapter 10. 



The increment and decrement operators 

Java has some neat little operators that make life easier (for the computer's 
processor, for your brain, and for your fingers). Altogether, four such opera- 
tors exist — two increment operators and two decrement operators. The 
increment operators add 1, and the decrement operators subtract 1. The 
increment operators use double plus signs (++), and the decrement opera- 
tors use double minus signs (- -). To see how they work, you need some 
examples. The first example is in Figure 4-10. 

A run of the program in Figure 4-10 is shown in Figure 4-11. In this horribly 
uneventful run, the count of bunnies is printed three times. 

The double plus signs go by two different names, depending on where you 
put them. When you put the ++ before a variable, the ++ is called the preincre- 
ment operator. (The pre stands for before?) 

The word before has two different meanings: 

You put ++ before the variable. 

I The computer adds 1 to the variable's value before the variable is used 
in any other part of the statement. 



Chapter 4: Making the Most of Variables and Their Values 



DropBooks 



Figure 4-10: 

Using 
preincre- 
ment. 



static java . lang . System. out ; 
prelncrementDemo { 
public static void main(String args [ ] ) { 
int numberOf Bunnies = 2 7; 

++numberOf Bunnies ; 



out .println (numberOf Bunnies ) ; — 
out .println(++numberOfBunnies) ; 

out .println (numberOf Bunnies ) ; 



numberOf Bunnies 
becomes 28. 



28 gets printed. 



numberOf Bunnies 
becomes 29, and 
29 gets printed. 



29 gets printed again. 



Figure 4-11: 

A run of 
the code in 
Figure 4-10. 




To understand this, look at the bold line in Figure 4-10. The computer adds 1 
tonumberOfBunnies (raising the value of numberOf Bunni es to 29), and then 
the computer prints the number 29 on-screen. 




With out . pri ntl n (++number0f Bunni es ), the computer adds 1 to 
numberOfBunnies before printing the new value ofnumberOfBunnies 
on-screen. 



An alternative to preincrement is postincrement. (The post stands for after?) 
The word after has two different meanings: 

*** You put ++ after the variable. 

The computer adds 1 to the variable's value after the variable is used in 
any other part of the statement. 

To see more clearly how postincrement works, look at the bold line in 
Figure 4-12. The computer prints the old value of numberOf Bunni es (which 
is 28) on the screen, and then the computer adds 1 to numberOf Bunni es, 
which raises the value of numberOf Bunni es to 29. 




With out.println(numberOfBunnies++), the computer adds 1 to 
numberOf Bunni es after printing the old value that numberOf Bunni es 
already had. 
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Figure 4-12: 

Using 
postincre- 
ment. 



static java . lang . System. out ; 
prelncrementDemo { 
public static void main(String args [ ] ) { 
int numberOf Bunnies = 2 7; 

numberOf Bunnies++ ; 



numbe r O f Bunn i e s 
becomes 28. 



out .println (numberOf Bunnies ) ; — 
out .println(numberOfBunnies++) ; ■ 

out .println (numberOf Bunnies ) ; 



28 gets printed. 



28 gets printed, and then 

numberOf Bunnies 
becomes 29. 



29 gets printed. 



A run of the code in Figure 4-12 is shown in Figure 4-13. Compare Figure 4-13 
with the run in Figure 4-11: 

With preincrement in Figure 4-11, the second number is 29. 

i>* With postincrement in Figure 4-13, the second number is 28. 

In Figure 4-13, the number 29 doesn't show up on-screen until 
the end of the run, when the computer executes one last 

out.println(numberOfBunnies). 



Figure 4-13: 

A run of 
the code in 
Figure 4-12. 




Are you trying to decide between using preincrement or postincrement? Try 
no longer. Most programmers use postincrement. In a typical Java program, 
you often see things like numberOf Bunn i es++. You seldom see things like 

++numberOfBunnies. 

In addition to preincrement and postincrement, Java has two operators that 
use - - . These operators are called predecrement and postdecrement. 

With predecrement (- -numberOf Bunni es), the computer subtracts 1 
from the variable's value before the variable is used in the rest of the 
statement. 

i>* With postdecrement (numberOfBunnies--), the computer subtracts 1 
from the variable's value after the variable is used in the rest of the 
statement. 
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and pre- and postdecrement operators in two 
ways: the way everyone understands them and 
the right way. The way that I explain the con- 
cept in most of this section (in terms of time, 
with before and after) is the way that everyone 
understands it. Unfortunately, the way everyone 
understands the concept isn't really the right 
way. When you see ++ or - -, you can think in 
terms of time sequence. Butoccasionally some 
programmer uses ++ or - - in a convoluted way, 
and the notions of before and afterbreak down. 
So, if you're ever in a tight spot, think about 
these operators in terms of statements and 
expressions. 

First, remember that a statement tells the 
computer to do something, and an expres- 
sion has a value. (I discuss statements in 
Chapter 3, and I describe expressions else- 
where in this chapter.) Which category does 
numberOf Bunni es++ belong to? The sur- 
prising answer is both. The Java code 
numberOf Bunni es++ is both a statement and 
an expression. 

Assume that, before the computer exe- 
cutes the code out . pri ntl n ( numberOf 
Bunnies++), the value of numberOf 
Bunnies is 28. 



As a statement, numberOf Bunnies++ 
tells the computer to add 1 to 

numberOfBunnies. 

As an expression, the value of 

numberOfBunnies++is 28, not29. 

So, even though the computer adds 1 

to numberOfBunnies, the code out. 
println(numberOfBunnies++) really 
means out. println(28). 

Now, almost everything you just read 
about numberOf Bunnies++ is true about 
++numberOfBunnies.The only difference is 
that as an expression, ++numberOf Bunni es 
behaves in a more intuitive way. 

As a statement, ++numberOf Bunni es 
tells the computer to add 1 to 

numberOfBunnies. 

*<" As an expression, the value of 

++numberOf Bunni es is 29. 

So, with out . pri ntl n (++numberOf 
Bunni es ), the computer adds 1 to the variable 
numberOfBunnies, and the code out. 
pri ntl n (++numberOf Bunni es ) really 
means out. println(29). 




Instead of writing ++numberOf Bunni es, you could achieve the same effect by 
writing numberOf Bunnies = numberOfBunnies + 1 . So some people con- 
clude that Java's ++ and - - operators are for saving keystrokes — to keep 
those poor fingers from overworking themselves. This is entirely incorrect. 
The best reason for using ++ is to avoid the inefficient and error-prone prac- 
tice of writing the same variable name, such as numberOf Bunn i es, twice in 
the same statement. If you write numberOf Bunni es only once (as you do when 
you use ++ or - -), the computer has to figure out what numberOf Bunni es 
means only once. On top of that, when you write numberOf Bunni es only 
once, you have only one chance (instead of two chances) to type the variable 
name incorrectly. With simple expressions like numberOf Bunni es++, these 
advantages hardly make a difference. But with more complicated expres- 
sions, like i nvento ry I terns [( quant ity Re ceived--*i terns PerBox+1 7) ]++, 
the efficiency and accuracy that you gain by using ++ and - - is significant. 
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d the preceding section, which is about operators that add 1, you 
wondering whether you can manipulate these operators to add 2 or 
add 5 or add 1000000. Can you write numberOf Bunni es++++ and still call 
yourself a Java programmer? Well, you can't. If you try it, an error message 
appears when you try to compile your code. 

So what can you do? As luck would have it, Java has plenty of assignment 
operators that you can use. With an assignment operator, you can add, sub- 
tract, multiply, or divide by anything you want. You can do other cool opera- 
tions, too. Listing 4-8 has a smorgasbord of assignment operators (the things 
with equal signs). Figure 4-14 shows the output from running Listing 4-8. 



Listing 4-8: Assignment Operators 

import static Java . 1 ang . System . out ; 

class UseAssi gnmentOperators { 

public static void main(String args[]) { 
int numberOf Bunnies = 27; 
int numberExtra = 53; 

numberOf Bunnies += 1; 

out. pr in tl n ( numberOf Bunni es ) ; 

numberOf Bunni es += 5; 
out.println ( numberOf Bunni es ) ; 

numberOf Bunnies += numberExtra; 
out.println(numberOfBunnies); 

numberOf Bunni es *= 2; 
out.println ( numberOf Bunni es ) ; 

out . pri ntl n ( numberOf Bunni es -= 7); 

out . pri ntl n ( numberOf Bunni es = 100); 

) 

) 



Figure 4-14: 

A run of 
the code in 
Listing 4-8. 



28 

33 

86 

172 

165 

100 

Process completed . 
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Listing 4-8 shows how versatile Java's assignment operators are. With the 
assignment operators, you can add, subtract, multiply, or divide a variable by 
,ber. Notice how += 5 adds 5 to numberOf Bunnies, and how *= 2 
numberOf Bunni es by 2. You can even use another expression's 
value (In Listing 4-8, numberExtra) as the number to be applied. 




The last two lines in Listing 4-8 demonstrate a special feature of Java's assign- 
ment operators. You can use an assignment operator as part of a larger Java 
statement. In the next to last line of Listing 4-8, the operator subtracts 7 from 
numberOfBunnies, decreasing the value ofnumberOfBunnies from 172 to 
165. But then the whole assignment business is stuffed into a call to 
out.println,so the number 1 6 5 is printed on the computer screen. 

Lo and behold, the last line of Listing 4-8 shows how you can do the same 
thing with Java's plain old equal sign. The thing that I call an assignment 
statement near the start of this chapter is really one of the assignment opera- 
tors that I describe in this section. So, whenever you assign a value to some- 
thing, you can make that assignment be part of a larger statement. 

Each use of an assignment operator does double duty as both a state- 
ment and an expression. In all cases, the expression's value equals 
whatever value you assign. For example, before executing the code 
out . pri ntl n ( numberOf Bunni es -= 7 ), the value of numberOf Bunni es 
is 172. As a statement, numberOf Bunni es -= 7 tells the computer to sub- 
tract 7 from numberOfBunnies (so the value ofnumberOfBunnies goes from 
172 down to 165). As an expression, the value of numberOf Bunni es -= 7 
is 165. So the code out . pri ntl n ( numberOf Bunni es -= 7 ) really means 
out.println(165). The number 1 65 is displayed on the computer screen. 



For a richer explanation of this kind of thing, see the sidebar, "Statements and 
expressions," earlier in this chapter. 
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Chapter 5 

Program Flow with 
Decision-Making Statements 

•••••••••••••••••••••••••••••••••••••••••••••a 

In This Chapter 

Writing statements that choose between alternatives 
Putting statements inside one another 
Choosing among many alternatives 



7 he TV show Dennis the Menace aired on CBS from 1959 to 1963. 1 remem- 
ber one episode in which Mr. Wilson was having trouble making an impor- 
tant decision. I think it was something about changing jobs or moving to a 
new town. Anyway, I can still see that shot of Mr. Wilson sitting in his yard, 
sipping lemonade, and staring into nowhere for the whole afternoon. Of 
course, the annoying character Dennis was constantly interrupting Mr. 
Wilson's peace and quiet. That's what made this situation funny. 

What impressed me about this episode (the reason why I remember it so 
clearly even now) was Mr. Wilson's dogged intent in making the decision. 
This guy wasn't going about his everyday business, roaming around the 
neighborhood, while thoughts about the decision wandered in and out of his 
mind. He was sitting quietly in his yard, making marks carefully and logically 
on his mental balance sheet. How many people actually make decisions 
this way? 

At that time, I was still pretty young. I'd never faced the responsibility of 
having to make a big decision that affected my family and me. But I wondered 
what such a decision-making process would be like. Would it help to sit there 
like a stump for hours on end? Would I make my decisions by the careful 
weighing and tallying of options? Or would I shoot in the dark, take risks, and 
act on impulse? Only time would tell. 
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re writing computer programs, you're constantly hitting forks in 
roads. Did the user correctly type his or her password? If yes, let the user 
work; if no, kick the bum out. So the Java programming language needs a way 
of making a program branch in one of two directions. Fortunately, the lan- 
guage has a way. It's called an if statement. 



Guess the number 

The use of an i f statement is illustrated in Listing 5-1. Two runs of the pro- 
gram in Listing 5-1 are shown in Figure 5-1. 



Listing 5-1 : A Guessing Game 

import static ja va . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . uti 1 . Random ; 

class GuessingGame { 

public static void main(String args[]) { 

Scanner myScanner = new Scanner ( System. i n ) ; 

out . pri nt( " Enter an int from 1 to 10: "); 

int inputNumber = myScanner. nextlntC ) ; 

int randomNumber = new Random( ) .nextlnt(lO) + 1; 

if (inputNumber == randomNumber) { 

out . pri ntl n( ) ; 
out . pri ntl n ( "*You win.*"); 
out . pri ntl n( ) ; 
} else { 

out . pri ntl n ( "You lose."); 

out . pri nt( "The random number was "); 

out . pri ntl n ( randomNumber + "."); 

} 

out . pri ntl n ( "Thank you for playing."); 

) 

) 
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The program in Listing 5-1 plays a guessing game with the user. The program 
gets a number (a guess) from the user and then generates a random number 
and 10. If the number that the user entered is the same as the 
umber, the user wins. Otherwise, the user loses. In either case, the 
program tells the user what the random number was. 



Figure 5-1: 

Two runs 
of the 

guessing 
game. 



General Output 

Conf igurat 

Enter an int from 1 to 10: 2 



*You win.* 

Thank you for playing. 
Process completed . 



General Output 

Conf igurat ion : 

Enter an int from 1 to 10: 4 
You lose . 

The random number was 10. 
Thank you for playing. 

Process completed. 



She controlled keystrokes 
from the keyboard 



Taken together, the lines 



import java.util 
Scanner 
int inpu 


. Scanner ; 
myScanner 
tNumber = 


= new Sea 
myScanner 


nner ( System .in); 
.nextlntC ) ; 




in Listing 5-1 get whatever number the user types on the keyboard. The last 
of the three lines puts this number into a variable named inputNumber. If 



these lines look complicated, don't worry. You can copy these lines almost 
word for word whenever you want to read from the keyboard. Include the 
first two lines (the import and Scanner lines) just once in your program. 
Later in your program, wherever the user types an int value, include a line 
with a call to nextl nt (as in the last of the three lines above). 

Of all the names in these three lines of code, the only two names that I coined 
myself are inputNumber and myScanner. All the other names are part of Java. 
So, if I want to be creative, I can write the lines this way: 

import java . uti 1 . Scanner ; 

Scanner readi ngThi ngi e = new Scanner (System . i n ) ; 

int val ueTypedln = readi ngThi ngi e . nextlnt( ) ; 
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I can also beef up my program's i mport declarations, as I do in Listings 5-2 
and 5-3. Other than that, I have very little leeway 






ad on in this book, you'll start recognizing the patterns behind 
these three lines of code, so I don't clutter up this section with all the details. 
For now, you can just copy these three lines and keep the following in mind: 

When you import java . uti 1 . Scanner, you don't use the word static. 

Importing Scanner is different from importing System . out. When you 
import java . 1 ang . System . out, you use the word static. (See Listing 5-1.) 

For the real story on the word static, see Chapter 10. 

The name System.in stands for the keyboard. 

To get characters from someplace other than the keyboard, you can 
type something other than System . i n inside the parentheses. 

What else can you put inside the parentheses? For some ideas, see 
Chapter 8. 

When you expect the user to type an i nt value (a whole number of 
some kind), use nextlnt( ). 

If you expect the user to type a doubl e value (a number containing a 
decimal point), use nextDoubl e( ). If you expect the user to type true or 
false, use nextBooleanO.If you expect the user to type a word (a word 
like Barry, Java, or Hello), use n ext ( ) . 

For an example in which the user types a word, see Listing 5-3. For an 
example in which the user types a single character, see Listing 6-4 in 
Chapter 6. For an example in which a program reads an entire line of text 
(all in one big gulp), see Chapter 8. 

V You can get several values from the keyboard, one after another. 

To do this, use the myScanner . nextl nt ( ) code several times. 

To see a program that reads more than one value from the keyboard, go 
to Listing 5-4. 



Creating randomness 

Achieving real randomness is surprisingly difficult. Mathematician Persi 
Diaconis says that if you flip a coin several times, always starting with the 
head side up, you're likely to toss heads more often than tails. If you toss sev- 
eral more times, always starting with the tail side up, you're likely to toss 
tails more often than heads. In other words, coin tossing isn't really fair.* 



* Diaconis, Persi. "The search for randomness. "American Association for the Advancement 
of Science annual meeting. Seattle. 14 Feb. 2004. 
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Computers aren't much better than coins and human thumbs. A computer 
mimics the generation of random sequences but, in the end, the computer 
what it's told and does all this in a purely deterministic fashion, 
ing 5-1, when the computer executes 



import j ava . uti 1 . Random ; 

int randomNumber = new Random( ) .nextlnt(lO) + 1; 



the computer appears to give us a randomly generated number — a whole 
number between 1 and 10. But it's all a fake. The computer just follows 
instructions. It's not really random, but without bending a computer over 
backwards, it's the best that anyone can do. 

Once again, I ask you to take this code on blind faith. Don't worry about what 
new RandomO.nextlnt means until you have more experience with Java. 



Just copy this code into your own programs and have fun with it. 
numbers from 1 to 10 aren't in your flight plans, don't fret. To roll 
nary die, write the statement 


And if the 
an imagi- 


int rollEmBaby = new Random( ) . nextlr 


it (6) + 1; 











With the execution of this statement, the variable roll EmBaby gets a value 
from 1 to 6. 



The if statement 

At the core of Listing 5-1 is a Java i f statement. This i f statement represents 
a fork in the road. (See Figure 5-2.) The computer follows one of two prongs — 
the prong that prints You wi n or the prong that prints You lose. The com- 
puter decides which prong to take by testing the truth or falsehood of a 
condition. In Listing 5-1, the condition being tested is 

inputNumber == randomNumber 

Does the value of i nputNumber equal the value of randomNumber? When the 
condition is true, the computer does the stuff between the condition and the 
word else. When the condition turns out to be false, the computer does the 
stuff after the word else. Either way, the computer goes on to execute the last 
pri ntl n call, which displays Thank you for playing. 




The condition in an i f statement must be enclosed in parentheses. However, 
a line like i f ( i nputNumber == randomNumber ) is not a complete statement, 
so this line shouldn't end with a semicolon. 
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Figure 5-2: 

An if 
statement is 
like a fork in 
the road. 



Does inputNumber 
equal randomNumber? 



yes 



*You win . * 



no 



You lose. 
The random 
number was . 



Thank you for playing. 




Sometimes, when I'm writing about a condition that's being tested, I slip into 
using the word expression instead of condition. That's okay, because every 
condition is an expression. An expression is something that has a value and, 
sure enough, every condition has a value. The condition's value is either 
true or false. (For revealing information about expressions, and values like 
true and f al se, see Chapter 4.) 



The double equal siqn 

In Listing 5-1, in the i f statement's condition, notice the use of the double 
equal sign. Comparing two numbers to see whether they're the same isn't the 
same as setting something equal to something else. That's why the symbol to 
compare for equality isn't the same as the symbol that's used in an assign- 
ment or an initialization. In an i f statement's condition, you can't replace the 
double equal sign with a single equal sign. If you do, your program just won't 
work. (You'll almost always get an error message when you try to compile 
your code.) 

On the other hand, if you never make the mistake of using a single equal sign 
in a condition, you're not normal. Not long ago, while I was teaching an intro- 
ductory Java course, I promised that I'd swallow my laser pointer if no one 
made the single equal sign mistake during any of the lab sessions. This 
wasn't an idle promise. I knew I'd never have to keep it. As it turned out, even 
if I had ignored the first ten times anybody made the single equal sign mis- 
take during those lab sessions, I would still be laser-pointer free. Everybody 
mistakenly uses the single equal sign several times in his or her programming 
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Brace yourself 

The i f statement in Listing 5-1 has two halves — a top half and a bottom half. 
I have names for these two parts of an i f statement. I call them the if part 
(the top half) and the else part (the bottom half). 

The i f part in Listing 5-1 seems to have more than one statement in it. I make 
this happen by enclosing the three statements of the i f part in a pair of curly 
braces. When I do this, I form a block. A block is a bunch of statements 
scrunched together by a pair of curly braces. 

With this block, three calls to pri ntl n are tucked away safely inside the i f 
part. With the curly braces, the rows of asterisks and the words You win are 
displayed only when the user's guess is correct. 

This business with blocks and curly braces applies to the else part as well. 
In Listing 5-1, whenever i nputNumber doesn't equal randomNumber, the com- 
puter executes three print/println calls. To convince the computer that all 
three of these calls are inside the else clause, I put these calls into a block. 
That is, I enclose these three calls in a pair of curly braces. 

Strictly speaking, Listing 5-1 has only one statement between the i f and the 
else statements, and only one statement after the else statement. The trick 
is that when you surround a bunch of statements inside curly braces, you get 
a block, and a block behaves, in all respects, like a single statement. In fact, 
the official Java documentation lists blocks as one of the many kinds of state- 
ments. So, in Listing 5-1, the block that prints You win and asterisks is a 
single statement. It's a statement that has, within it, three smaller statements. 



Indenting if statements in yom code 

Notice how, in Listing 5-1, the print and pri ntl n calls inside the i f state- 
ment are indented. (This includes both the You win and You lose state- 
ments. The print and pri ntl n calls that come after the word else are still 
part of the i f statement.) Strictly speaking, you don't have to indent the 
statements that are inside an i f statement. For all the compiler cares, you 
can write your whole program on a single line or place all your statements in 
an artful, misshapen zigzag. The problem is that if you don't indent your 
statements in some logical fashion, neither you nor anyone else can make 
sense of your code. In Listing 5-1, the indenting of the print and pri ntl n 
statements helps your eye (and brain) see quickly that these statements are 
subordinate to the overall i f/el se flow. 
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In a small program, unindented or poorly indented code is barely tolerable. 
But in a complicated program, indentation that doesn't follow a neat, logical 
a big, ugly nightmare. 



When you write i f statements, you may be tempted to chuck all the rules 
about curly braces out the window and just rely on indentation. Unfortunately, 
this seldom works. If you indent three statements after the word else and 
forget to enclose those statements in curly braces, the computer thinks that 
the else part includes only the first of the three statements. What's worse, 
the indentation misleads you into believing that the else part includes all 
three statements. This makes it more difficult for you to figure out why your 
code isn't behaving the way you think it should behave. So watch those braces! 



Etsetess in Ifrica 

Okay, so the title of this section is contrived. Big deal! The idea is that you 
can create an i f statement without the else part. Take, for instance, the 
code in Listing 5-1. Maybe you'd rather not rub it in whenever the user 
loses the game. The modified code in Listing 5-2 shows you how to do this 
(and Figure 5-3 shows you the result). 



Listing 5-2: A Kinder, Gentler 


Guessing Game 




import static ja 
import static ja 


va . 1 ang . Sy 
va . 1 ang . Sy 


'stem .in; 
'stem . out ; 







import j ava . uti 1 . Scanner ; 
import Java . uti 1 . Random; 



class DontTel 1 ThemThey Lost ( 



public static void main(String args[]) { 
Scanner myScanner = new Scanner(in); 

out . pri nt( " Enter an int from 1 to 10: "); 

int inputNumber = myScanner. nextlntC ) ; 

int randomNumber = new Random( ) .nextlnt(lO) + 1; 



if (inputNumber == randomNumber) { 
out.println("*You win.*"); 

} 



out . pri ntl n ( "That was a very good guess :-)"); 

out . pri nt( "The random number was "); 

out . pri ntl n ( randomNumber + "."); 

out . pri ntl n ( "Thank you for playing."); 



} 
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Figure 5-3: 



Listing 5-2. 




Conf iguratio 

ter an int from 1 to 10: 4 



very good guess 
number was 4 . 
for playing. 



General Output 

Conf igurat ion ; 

Enter an int from 1 to 10: 4 
That was a very good guess :-) 
The random number was 6 . 
Thank you for playing. 



The i f statement in Listing 5-2 has no el se part. When inputNumber is the 
same as randomNumber, the computer prints You wi n . When i nputNumber 
is different from randomNumber, the computer doesn't print You wi n . 

Listing 5-2 illustrates another new idea. With an import declaration for 
System . i n, I can reduce new Scanner( System .in) to the shorter new 
Scanner(in). Adding this import declaration is hardly worth the effort. In 
fact, I do more typing with the i mport declaration than without it. Nevertheless, 
the code in Listing 5-2 demonstrates that it's possible to import System . i n. 



Forming Conditions With Comparisons 
and Logical Operators 

The Java programming language has plenty of little squiggles and doodads 
for your various condition-forming needs. This section tells you all about them. 



Comparing numbers; comparing characters 

Table 5-1 shows you the operators that you can use to compare things with 
one another. 



Table 5-1 


Comparison Operators 


Operator Symbol 


Meaning 


Example 




is equal to 


numberOfCows == 5 


i = 


is not equal to 


buttonCl i eked != 
pani cButton 


< 


is less than 


numberOfCows < 5 


> 


is greater than 


my I n i t i a 1 > ' B ' 


<= 


is less than or equal to 


numberOfCows <= 5 


>= 


is greater than or equal to 


mylnitial >= 'B' 
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You can use all of Java's comparison operators to compare numbers and 
characters. When you compare numbers, things go pretty much the way you 
y should go. But when you compare characters, things are a little 
omparing uppercase letters with one another is no problem. 
Because the letter B comes alphabetically before H, the condition ' B ' < ' H ' 
is true. Comparing lowercase letters with one another is also okay. What's 
strange is that when you compare an uppercase letter with a lowercase letter, 
the uppercase letter is always smaller. So, even though ' Z ' < ' A ' is false, 
' Z ' < ' a ' is true. 

^J^^Jx Under the hood, the letters A through Z are stored with numeric codes 65 
through 90. The letters a through z are stored with codes 97 through 122. 
That's why each uppercase letter is smaller than each lowercase letter. 

^\NG/ Be careful when you compare two numbers for equality (with ==) or inequal- 
^/ ity(with !=). After doing some calculations and obtaining two do ubl e values 

or two float values, the values that you have are seldom dead-on equal to 
one another. (The problem comes from those pesky digits beyond the deci- 
mal point.) For instance, the Fahrenheit equivalent of 21 degrees Celsius is 
69.8, and when you calculate 9 . 0 / 5 * 21 + 32 by hand, you get 69.8. But 
the condition 9 . 0 / 5 * 21 + 32 == 69 . 8 turns out to be false. That's 
because, when the computer calculates 9 . 0 / 5 * 21 + 32, it gets 
69.80000000000001, not 69.8. 



Comparing objects 

When you start working with objects, you'll find that you can use == and ! = 
to compare objects with one another. For instance, a button that you see on 
the computer screen is an object. You can ask whether the thing that was just 
mouse-clicked is a particular button on your screen. You do this with Java's 
equality operator. 

if ( e . getSource( ) == bCopy) { 

cl i p board . setText(whi ch . getTextC ) ) ; 




To find out more about responding to button clicks, read Chapter 16 on this 
book's CD-ROM. 



The big gotcha with Java's comparison scheme comes when you compare 
two strings. (For a word or two about Java's String type, see the section 
about reference types in Chapter 4.) When you compare two strings with one 
another, you don't want to use the double equal sign. Using the double equal 
sign would ask, "Is this string stored in exactly the same place in memory as 
that other string?" That's usually not what you want to ask. Instead, you usu- 
ally want to ask, "Does this string have the same characters in it as that other 
string?" To ask the second question (the more appropriate question) Java's 
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String type has a method named equals. (Like everything else in the known 

universe, this equals method is defined in the Java API, short for Application 
rlaraHyning Interface.) The equal s method compares two strings to see 
ifeY^yhey have the same characters in them. For an example using Java's 

equals method, see Listing 5-3. (A run of the program in Listing 5-3 is shown 

in Figure 5-4.) 

Listing 5-3: Checking a Password 

import static Java . 1 ang . System .* ; 
import j ava . uti 1 . Scanner ; 

class CheckPassword { 

public static void main(String args[]) { 

out . pri nt( "What ' s the password? "); 

Scanner myScanner = new Scanner(in); 
String password = myScanner . next( ) ; 

out . pri ntl n ( " You typed >>" + password + "<<"); 
out . pri ntl n ( ) ; 

if (password == "swordfish") { 

out . pri ntl n ( "The word you typed is stored"); 

out . pri ntl n ( " i n the same place as the real"); 

out . pri ntl n ( "password . You must be a"); 

out. pri ntl n ( " hacker."); 
} else { 

out . pri ntl n ( "The word you typed is not"); 
out . pri ntl n ( "stored in the same place as"); 
out . pri ntl n ( "the real password, but that's"); 
out . pri ntl n ( "no big deal."); 

) 

out . pri ntl n ( ) ; 

if ( password . equal s (" swordfi sh" ) ) { 

out . pri ntl n ( "The word you typed has the"); 

out . pri ntl n ( "same characters as the real"); 

out . pri ntl n ( "password . You can use our"); 

out . pri ntl n ( "preci ous system .") ; 
} else { 

out . pri ntl n ( "The word you typed doesn't"); 
out . pri ntl n (" have the same characters as"); 
out . pri ntl n ( "the real password. You can't"); 
out . pri ntl n ( "use our precious system."); 

) 

) 

) 
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Configuration: 

What's the password? sword f ish 
You typed > >swordf ish< < 

you typed is not 
|Ln the same place as 
§Tl password, but that's 
no big deal . 

The word you typed has the 
same characters as the real 
password . You can use our 
precious system. 

Process completed . 



TTj 



In Listing 5-3, the call my Scanner, next ( ) grabs whatever word the user 
types on the computer keyboard. The code shoves this word into the vari- 
able named password. Then the program's i f statements use two different 
techniques to compare password with "swordf i sh". 

The more appropriate of the two techniques uses Java's equals method. The 
equals method looks funny when you call it, because you put a dot after one 
string and put the other string in parentheses. But that's the way you have to 
do it. 



In calling Java's equals method, it doesn't matter which string gets the dot 
and which gets the parentheses. For instance, in Listing 5-3, you could have 
written 



if (" swordf ish".equals(pass word)) 



The method would work just as well. 



A call to Java's equals method looks imbalanced, but it's not. There's a 
reason behind the apparent imbalance between the dot and the parenthe- 
ses. The idea is that you have two objects: the password object and the 
"swordf i sh " object. Each of these two objects is of type String. (However, 
password is a variable of type String, and " swordf i sh" is a Stri ng literal.) 
When you write password, equal s ( " swordf ish"), you're calling an equa 1 s 
method that belongs to the password object. As you call that method, you're 
feeding "swordf ish" to the method as the method's parameter (pun 
intended). 



4?/ 



You can read more about methods belonging to objects in Chapter 7. 

When comparing strings with one another, use the equals method, not the 
double equal sign. 



Chapter 5: Controlling Program Flow with Decision-Making Statements 



Importing everything, in one fett svVoop 
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line of Listing 5-3 illustrates a lazy way of importing both 
but and System . i n. To import everything that System has to 
offer, you use the asterisk wildcard character (*). In fact, importing 
ja va . 1 ang . System . * is like having about 30 separate import declarations, 

including System . i n, System . out, System . err, System . nanoTi me, and 
many other System things. 

The use of an asterisk in an i mport declaration is generally considered bad 
programming practice, so I don't do it often in this book's examples. But for 
larger programs — programs that use dozens of names from the Java API — 
the lazy asterisk trick is handy. 

You can't toss an asterisk anywhere you want inside an import declaration. 
For example, you can't import everything starting with java by writing 
import java.*. You can substitute an asterisk only for the name of a class 
or for the name of something static that's tucked away inside a class. For 
more information about asterisks in import declarations, see Chapter 9. For 
information about static things, see Chapter 10. 



Java's logical operators 

Mr. Spock would be pleased. Java has all the operators that you need for 
mixing and matching logical tests. The operators are shown in Table 5-2. 



Table 5-2 




Logical Operators 


Operator Symbol 


Meaning 


Example 


&& 


and 


5 < x && x < 10 


II 


or 


x < 5 || 10 < x 


] 


not 


[password. equalsC'swordfish") 



You can use these operators to form all kinds of elaborate conditions. 
Listing 5-4 has an example. 
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ilnport 
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i|np_p_rt static ja va . 1 ang . System . out ; 
Java. uti 1 . Scanner ; 



class Authenti cator { 

public static void main(String args[]) I 

Scanner myScanner = new Scanner ( System . i n ) 

out . pri nt( "Username : "); 
String username = myScanner . next( ) ; 

out . pri nt( " Password : "); 
String password = myScanner . next( ) ; 

if ( 

( username . equal s ( "bburd" ) && 
password . equal s ( "swordf i sh" ) ) | 
(username. equal s (" hri tter " ) && 
password . equal s ( "preakst on" ) ) 

) 

{ 

out . pri ntl n ( " You ' re in."); 

} else { 

out.println("You're suspicious."); 



Some runs of the program of Listing 5-4 are shown in Figure 5-5. When the 
username is bburd and the password is swordfish or when the username is 
hritter and the password is preakston, the user gets a nice message. 
Otherwise, the user is a bum who gets the nasty message that he or she 
deserves. 



Figure 5-5: 

Using 
logical 
operators. 



General Output 


2=4 .. . * Uenerai Uutput 


' u*uiiyujuj 


Username : bburd 
Password : swordf ish 
You 're in. 


General Output 

Username : hritter 
L , Password : preakston 
Username: hritter You're in 
Password : swordf ish 


General Output 

Ct 

Username: jschmoe 
Password : preakston 


0 


You're suspicious. <j 


You're suspicious. 


□ General nut... iTOniiild 


□ General ... 1 0*1 Build Out 


<i 



Keep an eye on those parentheses! When you're combining comparisons with 
logical operators, it's better to waste typing effort and add unneeded paren- 
theses than to goof up your result by using too few parentheses. Take, for 
example, the expression 
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2 < 5 | | 100 < 6 && 27 < 1 
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ading this expression, you may come to the conclusion that the 
n is false. That is, you could wrongly read the expression as mean- 
ing (somethi ng-or-other) && 27 < 1. Because 27 < 1 is false, you would 
conclude that the whole expression is false. The fact is that, in Java, any && 
operator is evaluated before any | | operator. So the expression really asks 
if 2 < 5 | ! ( someth ing-or-other ). Because 2 < 5 is true, the whole 
expression is true. 

To change the expression's value from true to false, you can put the 
expression's first two comparisons in parentheses, like this: 

(2 < 5 || 100 < 6) && 27 < 1 

Java's | | operator is inclusive. This means that you get a true value when- 
ever the thing on the left side is true, the thing on the right side is true, or 
both things are true. For instance, the expression 2 < 10 || 20 < 30 is true. 

In Java, you can't combine comparisons the way you do in ordinary 
English. In English, you may say, "We'll have between three and ten people 
at the dinner table." But in Java, you get an error message if you write 
3 <= people <= 10. To do this comparison, you need something like 

3 <= people && people <= 10. 



Building a Nest 



Have you seen those cute Russian Matryoshka nesting dolls? Open up one, 
and another one is inside. Open up the other, and a third one is inside it. You 
can do the same thing with Java's i f statements. (Talk about fun!) Listing 5-5 
shows you how. 

Listing 5-5: Nested if Statements 

import static ja va . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 

class Authenti cator2 { 

public static void main(String args[]) I 

Scanner myScanner = new Scanner ( System . i n ) ; 

out . pri nt( "Username : "); 

String username = myScanner. next( ) ; 



(continued) 
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if ( username . equal s (" bburd" ) ) { 
out . pri nt( " Password : "); 
String password = myScanner . next( ) ; 

if ( password . equa 1 s (" swordfi sh" ) ) { 
out . pri ntl n ( " You ' re in."); 

} else { 

out. pri ntl n ( " Incorrect password") 



) else { 

out . pri ntl n ( "Unknown user") 



Figure 5-6 shows several runs of the code in Listing 5-5. The main idea is that 
to log on, you have to pass two tests. (In other words, two conditions must 
be true.) The first condition tests for a valid username; the second condition 
tests for the correct password. If you pass the first test (the username test), 
you march right into another i f statement that performs a second test (the 
password test). If you fail the first test, you never make it to the second test. 
The overall plan is shown in Figure 5-7. 



Figure 5-6: 

Authenticat- 
ing a user. 
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General Output 




General Output 


Username : bburd 
Password: sword fish 
You 're in . 

I<T m 






— C 




Cor 


Username : bburd 
Password : catf ish 
Incorrect passworc 




< 
r 


'Jsernaie : 3 schmae 
Unknown user 
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The code in Listing 5-5 does a good job with nested i f statements, but it 
does a terrible job with real-world user authentication. First of all, never 
show a password in plain view (without asterisks to masquerade the pass- 
word). Second, don't handle passwords without encrypting them. Third, 
don't tell the malicious user which of the two words (the username or the 
password) was entered incorrectly. Fourth . . . well I could go on and on. The 
code in Listing 5-5 just isn't meant to illustrate good username/password 
practices. 
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Figure 5-7: 

Don't try 
eating with 
this fork. 



Does username 
equal "bburd"? 



Unknown 
user 



yes 



Does password 
equal "swordfish"? 



no 



Incorrect 
password 



yes 



You're in 



Choosing among Many Alternatives 
(Jatfa switch Statements) 

I'm the first to admit that I hate making decisions. If things go wrong, I would 
rather have the problem be someone else's fault. Writing the previous sec- 
tions (on making decisions with Java's i f statement) knocked the stuffing 
right out of me. That's why my mind boggles as I begin this section on choos- 
ing among many alternatives. What a relief it is to have that confession out of 
the way! 
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Al's All Wet' 
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'Gentille Alouette" 



Al's all wet. Oh, why is Al all wet? Oh, 

Al's all wet 'cause he's standing in the rain. 

Why is Al out in the rain? 

That's because he has no brain. 

Has no brain, has no brain. 

In the rain, in the rain. 

Ohhhhhhhh. ... 

Al's all wet. Oh, why is Al all wet? Oh, 

Al's all wet 'cause he's standing in the rain. 

Why is Al out in the rain? 

That's because he is a pain. 

He's a pain, he's a pain, 

Has no brain, has no brain. 

In the rain, in the rain. 

Ohhhhhhhh.... 



Al's all wet. Oh, why is Al all wet? Oh, 

Al's all wet 'cause he's standing in the rain. 

Why is Al out in the rain? 

'Cause this is the last refrain. 

Last refrain, last refrain, 

He's a pain, he's a pain. 

Has no brain, has no brain, 

In the rain, in the rain. 

Ohhhhhhhh.... 

Al's all wet. Oh, why is Al all wet? Oh, 
Al's all wet 'cause he's standing in the rain. 

-Harriet Ritter and Barry Burd 



\lour basic switch statement 

Now, it's time to explore situations in which you have a decision with many 
branches. Take, for instance, the popular campfire song "Al's All Wet." (For a 
review of the lyrics, see the sidebar.) You're eager to write code that prints 
this song's lyrics. Fortunately, you don't have to type all the words over and 
over again. Instead, you can take advantage of the repetition in the lyrics. 

A complete program to display the "Al's All Wet" lyrics won't come until 
Chapter 6. In the meantime, assume that you have a variable named verse. 
The value of verse is 1,2, 3, or 4, depending on which verse of "Al's All Wet" 
you're trying to print. You could have a big, clumsy bunch of i f statements 
that checks each possible verse number. 

if (verse == 1) I 

out . pri ntl n ( "That ' s because he has no brain."); 

) 

if (verse == 2) { 

out . pri ntl n ( "That ' s because he is a pain."); 

) 

if (verse == 3) I 

out . pri ntl n ("' Cause this is the last refrain."); 
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But that approach seems wasteful. Why not create a statement that checks 
the value of verse just once and then takes an action based on the value that 
7 ortunately just such a statement exists. It's called a switch state- 
ting 5-6 has an example of a swi tch statement. 

Listing 5-6: A switch Statement 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 

class JustSwi tch It ( 

public static void main(String args[]) { 

Scanner myScanner = new Scanner ( System . i n ) ; 

out . pri nt( "Whi ch verse? "); 

int verse = myScanner . nextlnt () ; 

switch (verse) { 
case 1: 

out . print! n ( 

break ; 
case 2: 

out . pri ntl n ( 

break; 
case 3: 

out . pri ntl n ( 

break; 
def aul t : 

out . pri ntl n ( 

break; 

) 

out.println("Ohhhhhhhh. . . ."); 

) 

) 

Figure 5-8 shows two runs of the program in Listing 5-6. (The overall idea 
behind the program is illustrated in Figure 5-9.) First, the user types a 
number, like the number 2. Then, execution of the program reaches the top of 
the swi tch statement. The computer checks the value of the verse variable. 
When the computer determines that the verse variable's value is 2, the com- 
puter checks each case of the switch statement. The value 2 doesn't match 
the topmost case, so the computer proceeds on to the middle of the three 
cases. The value posted for the middle case (the number 2) matches the 
value of the verse variable, so the computer executes the statements that 
come immediately after case 2. These two statements are 



"That's because he has no brain."); 

"That's because he is a pain."); 

"'Cause this is the last refrain."); 

"No such verse. Please try again."); 
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nair on 



out . pri ntl n ( "That ' s because he is a pain.") 
break; 



of the two statements displays the line That ' s because he is a 
pain, on the screen. The second statement is called a break statement. 
(What a surprise!) When the computer encounters a break statement, the 
computer jumps out of whatever switch statement it's in. So, in Listing 5-6, 
the computer skips right past the case that would display 'Cause this is 
the last refrai n . In fact, the computer jumps out of the entire swi tch 
statement and goes straight to the statement just after the end of the switch 
statement. The computer displays Ohhhhhhhh. . . . because that's what 
the statement after the switch statement tells the computer to do. 



Figure 5-8: 

Running 
the code of 
Listing 5-6. 



General Output 



Which verse? 2 
That's because he 

Ohhhhhhhh. . . . 



-Conf igur 



is a pain 



General Output 



-Conf igurat ion : 



Uhich verse? 6 
Ho such verse. Please try again 
Ohhhhhhhh. . . . 



Which verse is this? 



1 2 3 other 



Figure 5-9: 

The big 
fork in the 

code of 
Listing 5-6. 



Has no 
brain 



Is a 
pain 



Last 
refrain 



Try 
again 



Ohhhhhhhh . 



If the pesky user asks for verse 6, the computer responds by dropping past 
cases 1, 2, and 3. Instead, the computer does the default. In the default, the 
computer displays N o such verse. Please try a ga i n, and then breaks 
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out of the switch statement. After the computer is out of the swi tch state- 
ment, the computer displays Oh hhhhhhh . . . . 

really need to put a brea k at the very end of a swi tch statement. 
In Listing 5-6, the last break (the brea k that's part of the default) is just for 
the sake of overall tidiness. 



To break or not to break 

In every Java programmer's life, a time comes when he or she forgets to use 
break statements. At first, the resulting output is confusing, but then the pro- 
grammer remembers fall-through. The term fall-through describes what hap- 
pens when you end a case without a b r e a k statement. What happens is that 
execution of the code falls right through to the next case in line. Execution 
keeps falling through until you eventually reach a brea k statement or the end 
of the entire switch statement. 

Usually, when you're using a swi tch statement, you don't want fall-through, 
so you pepper break statements throughout the swi tch statements. But, 
occasionally, fall-through is just the thing you need. Take, for instance, the 
"Al's All Wet" song. (The classy lyrics are shown in the sidebar bearing the 
song's name.) Each verse of "Al's All Wet" adds new lines in addition to the 
lines from previous verses. This situation (accumulating lines from one verse 
to another) cries out for a swi tch statement with fall-through. Listing 5-7 
demonstrates the idea. 

Listing 5-7: A switch Statement with Fall-Through 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 

class Fal 1 i ngForYou { 

publ i c stati c void ma 
Scanner myScanner 
out . pri nt( "Which 
int verse = mySca 

switch (verse) { 
case 3: 

out . pri nt( " La 

out . pri ntl n ( " 
case 2: 

out . pri nt( "He 

out . pri ntl n ( " 

(continued) 



oks 



i n ( Stri ng a rgs[] ) { 
= new Scanner ( System . i n ) ; 
verse? " ) ; 
nner . nextlnt ( ) ; 



st refrain, "); 
last refrain,"); 

's a pain, "); 
he's a pain,"); 
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case 1: 

out . pri nt( "Has no brain, "); 
out . pri ntl n ( " has no brain,"); 



out . pri ntl n ( " In the rain, in the rain."); 
out.println("Ohhhhhhhh. . ."); 
out . pri ntl n ( ) ; 



} 



Figure 5-10 shows several runs of the program in Listing 5-7. Because the 
switch has no brea k statements in it, fall-through happens all over the place. 
For instance, when the user selects verse 2, the computer executes the two 
statements in case 2: 



out. print ("He's a pain, "); 
out . pri ntl n ( " he ' s a pain,"); 






Then, the computer marches right on to execute the two statements in case 1: 


out. print ("Has no brain, "); 
out . pri ntl n (" has no brain,"); 







That's good, because the song's second verse has all these lines in it. 



Figure 5-10: 

Running 
the code of 
Listing 5-7. 



Conf igu 

Which verse? 1 
Has no brain, has no brain. 
In the rain, in the rain. 
Ohhhhhhhh . . . 



<J m 

□ General 0... | [g Build Outp... S 

Cont igui 

Which verse? 3 
Last refrain, last refrain. 
He's a pain, he's a pain. 
Has no brain, has no brain. 
In the rain, in the rain. 
Ohhhhhhhh . . . 



General Output 



—Conf igur 



Which verse? 2 
He's a pain, he's a pain. 
Has no brain, has no brain, 
In the rain, in the rain. 
Ohhhhhhhh, , , 

£1- w- .1 [ 
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Which verse? 6 
In the rain, in the rain. 
Ohhhhhhhh . . . 



Notice what happens when the user asks for verse 6. The switch statement 
in Listing 5-7 has no case 6 and no default, so none of the actions inside the 
switch statement are executed. Even so, with statements that print In the 
rain, in the rain and Ohhhhhhhh right after the switch statement, the 
computer displays something when the user asks for verse 6. 
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In This Chapter 

Using basic looping 
Counting as you loop 

Impressing your friends with Java's newly enhanced loops 



f 

■ n 1966, the company that brings you Head & Shoulders shampoo made 
.tg history. On the back of the bottle, the directions for using the shampoo 
read, "LATHER-RINSE-REPEAT." Never before had a complete set of directions 
(for doing anything, let alone shampooing your hair) been summarized so 
succinctly. People in the direction-writing business hailed this as a monumen- 
tal achievement. Directions like these stood in stark contrast to others of the 
time. (For instance, the first sentence on a can of bug spray read, "Turn this 
can so that it points away from your face." Duh!) 

Aside from their brevity, the thing that made the Head & Shoulders directions 
so cool was that, with three simple words, they managed to capture a notion 
that's at the heart of all instruction giving — the notion of repetition. That 
last word, REPEAT, took an otherwise bland instructional drone and turned it 
into a sophisticated recipe for action. 

The fundamental idea is that when you're following directions, you don't just 
follow one instruction after another. Instead, you take turns in the road. You 
make decisions ("If HAIR IS DRY, then USE CONDITIONER") and you go into 
loops ("LATHER-RINSE, and then LATHER-RINSE again."). In computer pro- 
gramming, you use decision making and looping all the time. This chapter 
explores looping in Java. 
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Here's a guessing game for you. The computer generates a random number 
from 1 to 10. The computer asks you to guess the number. If you guess incor- 
rectly the game continues. As soon as you guess correctly, the game is over. 
The program to play the game is shown in Listing 6-1, and a round of play is 
shown in Figure 6-1. 



Listing 6-1 : A Repeating Guessing Game 



import static ja va . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . uti 1 . Random ; 

class GuessAgain { 

public static void main(String args[]) { 

Scanner myScanner = new Scanner ( System. i n ) 



int numGuesses = 
int randomNumber 



0; 



new Random( ) . nextlnt( 10) + 1 



out. pri ntl n(" ************ ») 

out . pri ntl n ( "Wei come to the Guessing Game") 

out. pri ntl n(" ************ ») 
out . pri ntl n ( ) ; 



out . pri nt ( " Enter 
int inputNumber = 
numGuesses++ ; 



an int from 1 to 10: ' 
my Scanner. n ext Int( ) ; 



); 



while (inputNumber != randomNumber) { 

out . pri ntl n ( ) ; 

out . pri ntl n ( "Try again..."); 
out . pri nt( " Enter an int from 1 to 10: 
inputNumber = myScanner. nextlntC ) ; 
numGuesses++ ; 



} 

out 
out 



printC'You win after 
pri ntl n ( numGuesses + 



) 



guesses . " ) 



") 
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Figure 6-1: 

Play until 
you drop. 



Lonf iqi.ua.tir 

************ 

Welcome to the Guessing Game 



************ 



int from 1 to 10 : 2 



Try again . . . 
Enter an int from 1 to 10: 5 

Try again . . . 

Enter an int from 1 to 10 : 8 
Try again . . . 

Enter an int from 1 to 10 : 3 
You win after 4 guesses. 



In Figure 6-1, the user makes four guesses. Each time around, the computer 
checks to see whether the guess is correct. An incorrect guess generates a 
request to try again. For a correct guess, the user gets a rousing You win, 
along with a tally of the number of guesses he or she made. The computer 
repeats several statements over and over again, checking each time through 
to see whether the user's guess is the same as a certain randomly generated 
number. Each time the user makes a guess, the computer adds 1 to its tally of 
guesses. When the user makes the correct guess, the computer displays that 
tally. The flow of action is illustrated in Figure 6-2. 



Welcome to the Guessing Game 
Enter an int from 1 to 10: 
Get inputNumber from the user 
Add 1 to numGuesses 



Figure 6-2: 

Around 
and around 
you go. 



Compare inputNumber and randomNumber 



They're different 



Try again... 

Enter an int from 1 to 10: 

Get inputNumber from the user 

Add 1 to numGuesses 



They're the same 



You win after numGuesses 
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When you look over Listing 6-1, you see the code that does all this work. 
At the core of the code is a thing called a while statement (also known as a 
<p). Rephrased in English, the while statement would say 



the inputNumber is not equal to the randomNumber 
keep doing all the stuff in curly braces: 1 




1 

The stuff in curly braces (the stuff that repeats over and over again) is the 
code that prints Try agai n, and then Enter an int . . .getsavalue 
from the keyboard and adds 1 to the count of the user's guesses. 

When you're dealing with counters, like numGuesses in Listing 6-1, you may 
easily become confused and be off by 1 in either direction. You can avoid this 
headache by making sure that the ++ statements stay close to the statements 
whose events you're counting. For example, in Listing 6-1, the variable 
numGuesses starts off with a value of 0. That's because, when the program 
starts running, the user hasn't made any guesses. Later in the program, right 
after each call to myScanner . nextlnt, is a numGuesses++ statement. That's 
how you do it — you increment the counter as soon as the user enters 
another guess. 

The statements in curly braces are repeated as long as i nputN umber ! = 
randomNumber keeps being true. Each repetition of the statements in the 
loop is called an iteration of the loop. In Figure 6-1, the loop undergoes 
three iterations. (If you don't believe that Figure 6-1 has exactly three itera- 
tions, count the number of Try again printings in the program's output. 
A T ry again appears for each incorrect guess.) 



When, at long last, the user enters the correct guess, the computer goes back 
to the top of the while statement, checks the condition in parentheses, and 
finds itself in double negative land. The not equal (! =) relationship between 
i nputNumber and randomNumber no longer holds. In other words, the while 
statement's condition, inputNumber != randomNumber, has become false. 
Because the while statement's condition is false, the computer jumps past 
the while loop and goes on to the statements just below the while loop. In 
these two statements, the computer prints You win after 4 guesses. 

With code of the kind shown in Listing 6-1, the computer never jumps out 
in mid-loop. When the computer finds that i nputNumber isn't equal to 
randomNumber, the computer marches on and executes all five statements 
inside the loop's curly braces. The computer performs the test again (to see 
whether i nputNumber is still not equal to randomNumber) only after it fully 
executes all five statements in the loop. 
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"Write 'I will not talk in class' on the blackboard 100 times." 
What your teacher really meant was, 

Set the count to 0. 

As long as the count is less than 100, 

Write 'I will not talk in class' on the blackboard, 
Add 1 to the count. 

Fortunately you didn't know about loops and counters at the time. If you 
pointed all this stuff out to your teacher, you'd have gotten into a lot more 
trouble than you were already in. 

One way or another, life is filled with examples of counting loops. And com- 
puter programming mirrors life — or is it the other way around? When you 
tell a computer what to do, you're often telling the computer to print three 
lines, process ten accounts, dial a million phone numbers, or whatever. 
Because counting loops are so common in programming, the people who 
create programming languages have developed statements just for loops of 
this kind. In Java, the statement that repeats something a certain number 
of times is called a for statement. The use of the for statement is illustrated 
in Listings 6-2 and 6-3. Listing 6-2 has a rock-bottom simple example, and 
Listing 6-3 has a more exotic example. Take your pick. 

Listing 6-2: The World's Most Boring for Loop 

import static Java . 1 ang . System . out ; 

class Yawn { 

public static void main(String args[]) { 

for (int count = 1; count <= 10; count++) { 

out . pri nt( "The value of count is "); 
out . pri nt ( count ) ; 
out . pri ntl n ( " . " ) ; 

} 

out . pri ntl n ( "Done ! " ) ; 

) 

) 
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Figure 6-3 shows you what you get when you run the program of Listing 6-2. 
(You get exactly what you deserve.) The for statement in Listing 6-2 starts 
the count variable equal to 1. Then the statement tests to make 
count is less than or equal to 10 (which it certainly is). Then the 
statement dives ahead and executes the printing statements between the 
curly braces. (At this early stage of the game, the computer prints The 
value of count is 1 .) Finally, the for statement does that last thing 
inside its parentheses — it adds 1 to the value of count. 



Figure 6-3: 

Counting 
to ten. 



The value 
The value 
The value 
The value 
The value 
The value 
The value 
The value 
The value 
The value 
Done ! 
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of count is 1 

of count is 2 

of count is 3 

of count is 4 

of count is 5 

of count is 6 

of count is 7 

of count is 8 

of count is 9 

of count is 10. 



With count now equal to 2, the for statement checks again to make sure that 
count is less than or equal to 10. (Yes, 2 is smaller than 10.) Because the test 
turns out okay, the for statement marches back into the curly braced state- 
ments and prints The value of count is 2 on the screen. Finally, the for 
statement does that last thing inside its parentheses — it adds 1 to the value 
of c o u n t , increasing the value of c o u n t to 3 . 

And so on. This whole thing keeps being repeated over and over again until, 
after 10 iterations, the value of count finally reaches 11. When this happens, 
the check for count being less than or equal to 10 fails, and the loop's execu- 
tion ends. The computer jumps to whatever statement comes immediately 
after the for statement. In Listing 6-2, the computer prints Done ! The whole 
process is illustrated in Figure 6-4. 



The anatomy of a for statement 

After the word for, you always put three things in parentheses. The first of 
these three things is called an initialization, the second is an expression, and 
the third thing is called an update. 

for ( initialization ; expression ; update ) 
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Figure 6-4: 

The action 
of the for 
loop in 
Listing 6-2. 



Set count to 1 



Is count less than or equal to 10? 



yes 



The value of count is . 
Add 1 to count 



Done 



Each of the three items in parentheses plays its own distinct role: 

v* The initialization is executed once, when the run of your program first 
reaches the for statement. 

*** The expression is evaluated several times (before each iteration). 

The update is also evaluated several times (at the end of each iteration). 



If it helps, think of the loop as if its text is shifted all around: 

int count = 1 
for count <= 10 { 

out . pri nt( "The value of count is "); 

out . pri nt ( count ) ; 

out . pri ntl n ( " . " ) ; 

count++ 



You can't write a real for statement this way. Even so, this is the order in 
which the parts of the statement are executed. 




If you declare a variable in the initialization of a for loop, you can't use that 
variable outside the loop. For instance, in Listing 6-2, you get an error mes- 
sage if you try putting out.println(count) after the end of the loop. 

Anything that can be done with a for loop can also be done with awhile 
loop. Choosing to use a for loop is a matter of style and convenience, not 
necessity. 
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The World premiere o( "Al's All Wet" 



2 is very nice, but the program in that listing doesn't do anything 
lg. For a more eye-catching example, see Listing 6-3. In Listing 6-3, 
I make good on a promise I made in Chapter 5. The program in Listing 6-3 
prints all the lyrics of the hit single, "Al's All Wet." (You can find the lyrics in 
Chapter 5.) 



Listing 6-3: The Unabridged "Al's All Wet" Song 

import static Java . 1 ang . System . out ; 

class AlsAllWet ( 

public static void main(String args[]) { 

for (int verse = 1; verse <= 3; verse++) { 
out . pri nt( "Al ' s all wet. "); 
out . pri ntl n ( "Oh , why is Al all wet? Oh,"); 
out . pri nt( "Al ' s all wet 'cause "); 
out . pri ntl n ( " he ' s standing in the rain."); 
out . pri ntl n ( "Why is Al out in the rain?"); 

switch (verse) I 
case 1: 

out . pri ntl n 

("That's because he has no brain."); 
brea k ; 
case 2: 

out . pri ntl n 

("That's because he is a pain."); 
brea k ; 
case 3: 

out . pri ntl n 

("'Cause this is the last refrain."); 
brea k ; 

) 

switch (verse) { 
case 3: 

out . pri ntl n (" Last refrain, last refrain,") 
case 2: 

out . pri ntl n ( " He ' s a pain, he's a pain,"); 

case 1: 

out . pri ntl n (" Has no brain, has no brain,") 

) 

out . pri ntl n ( " In the rain, in the rain."); 
out.println("Ohhhhhhhh. . ."); 
out . pri ntl n ( ) ; 
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out . pri nt( "Al ' s all wet. "); 

out . pri ntl n ( "Oh , why is Al all wet? Oh,") 

out . pri nt( "Al ' s all wet 'cause "); 

out . pri ntl n ( " he ' s standing in the rain.") 



Listing 6-3 is nice because it combines many of the ideas from Chapters 5 and 
6. In Listing 6-3, two switch statements are nested inside a for loop. One of 
the switch statements uses break statements; the other switch statement 
uses fall-through. As the value of the for loop's counter variable (verse) 
goes from 1 to 2 and then to 3, all the cases in the switch statements are 
executed. When the program is near the end of its run and execution has 
dropped out of the for loop, the program's last four statements print the 
song's final verse. 

^fd-Sty^ When I boldly declare that a f o r statement is for counting, I'm stretching the 
<j5^£**r\ truth just a bit. Java's for statement is very versatile. You can use a for 
t^y V$ ) statement in situations that have nothing to do with counting. For instance, a 
statement with no update part, such as for ( i =0 ; i <10 ;), just keeps on 
going. The looping ends when some action inside the loop assigns a big 
number to the variable i . You can even create a for statement with nothing 
inside the parentheses. The loop f or ( ; ; ) runs forever, which is good if 
the loop controls a serious piece of machinery. Usually, when you write a for 
statement, you're counting how many times to repeat something. But, in 
truth, you can do just about any kind of repetition with a f o r statement. 




Listing 6-3 uses break statements to jump out of a swi tch. But a break state- 
ment can also play a role inside a loop. To see an example, visit this book's 
Web site. 



Repeating Until \lou Get What \lou Want 
(Ja</a da Statements) 

"Fools rush in where angels fear to tread. " 

— Alexander Pope 

Today, I want to be young and foolish (or, at the very least, foolish). Look 
back at Figure 6-2 and notice how Java's while loop works. As execution 
enters awhile loop, the computer checks to make sure that the loop's condi- 
tion is true. If the condition isn't true, the statements inside the loop are 
never executed — not even once. In fact, you can easily cook up a whi 1 e loop 
whose statements are never executed (although I can't think of a reason why 
you would ever want to do it). 



Part II: Writing Your Own Java Programs 



int twoPlusTwo 



3 Books 

oui 



(twoPlusTwo == 5) I 
ft . pri ntl n( "Are you kidding?"); 
out . pri ntl n ( "2 + 2 doesn't equal 5"); 
out . pri nt( " Everyone knows that"); 
out . pri ntl n ( " 2 + 2 equals 3"); 



In spite of this silly twoPlusTwo example, the while statement turns out to 
be the most versatile of Java's looping constructs. In particular, the while 
loop is good for situations in which you must look before you leap. For exam- 
ple: "While money is in my account, write a mortgage check every month." 
When you first encounter this statement, if your account has a zero balance, 
you don't want to write a mortgage check — not even one check. 

But at times (not many), you want to leap before you look. Take, for instance, 
the situation in which you're asking the user for a response. Maybe the user's 
response makes sense, but maybe it doesn't. If it doesn't, you want to ask 
again. Maybe the user's finger slipped, or perhaps the user didn't understand 
the question. 

Figure 6-5 shows some runs of a program to delete a file. Before deleting the 
file, the program asks the user whether making the deletion is okay. If the 
user answers y or n, the program proceeds according to the user's wishes. 
But if the user enters any other character (any digit, uppercase letter, punctu- 
ation symbol, or whatever), the program asks the user for another response. 



-Con£ igu 



Figure 6-5: 

Checking 
before you 
delete a file. 



Delete evidence? (y/n) n 
Sorry, buddy. Just asking 



process romp 1 e t ed 



JlSBu.JOTa... raon... fjjjl 



General Output * 
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Delete evidence? (y/n) u 
Delete evidence? (y/n) Y 
Delete evidence? (y/n) L 
Delete evidence? (y/n) 8 
Delete evidence? (y/n) . 
Delete evidence? (y/n) y 
Okay . here goes . . . 

Process completed 



To write this program, you need a loop — a loop that repeatedly asks the 
user whether the file should be deleted. The loop keeps asking until the user 
gives a meaningful response. Now, the thing to notice is that the loop doesn't 
need to check anything before asking the user the first time. Indeed, before 
the user gives the first response, the loop has nothing to check. The loop 
doesn't start with "as long as such-and-such is true, then get a response from 
the user." Instead, the loop just leaps ahead, gets a response from the user, 
and then checks the response to see if it made sense. 
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That's why the program in Listing 6-4 has a do loop (also known as a do . , . 
while loop). With a do loop, the program jumps right in, takes action, and 

,cks a condition to see whether the result of the action makes sense. 
It makes sense, execution of the loop is done. If not, the program 
goes back to the top of the loop for another go-around. 



Listing 6-4: To Delete, or Not to Delete 

import j ava . i o . Fi 1 e ; 

import static Java . 1 ang . System. out ; 

import j ava . uti 1 . Scanner ; 

class Del eteEvi dence { 

public static void main(String args[]) { 

File evidence = new Fi 1 e( "c : WcookedBooks . txt " ) ; 
Scanner myScanner = new Scanner ( System . i n ) ; 
char reply; 

do { 

out . pri nt( "Del ete evidence? (y/n) "); 
reply = myScanner . next (). charAt( 0 ) ; 
} while (reply != 'y' && reply != 'n'); 

if (reply == 'y' ) { 

out . pri ntl n ( "Okay , here goes..."); 

evidence .del ete( ) ; 
} else { 

out . pri ntl n ( "Sorry , buddy. Just asking."); 

) 

) 

) 

Figure 6-5 (shown previously) shows two runs of the code in Listing 6-4. The 
program accepts lowercase letters y and n, but not the uppercase letters Y 
and N. To make the program accept uppercase letters, change the conditions 
in the code as follows: 

do ( 

out . pri nt( "Del ete evidence? (y/n) "); 
reply = myScanner . next (). charAt( 0 ) ; 
) while (reply! = 'y' && reply != "Y" && 
reply != 'n' && reply!='N'); 

if (reply == 'y' || reply == 'Y') 

Figure 6-6 shows the flow of control in the loop of Listing 6-4. With ado loop, 
the situation in the twoPlusTwo program (shown earlier) can never happen. 
Because the do loop carries out its first action without testing a condition, 
every do loop is guaranteed to perform at least one iteration. 
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Figure 6-6: 

Here we 
go loop, 
do loop. 



Delete evidence? 



no 



- Was the reply either y or n? 



yes 



Delete the file, or don't 
delete the file (depending 

on the reply) 



Reading a single character 

In Listing 5-3, the user types a word on the keyboard. The my Scanner, next 
method grabs the word, and places the word into a Stri ng variable named 
password. Everything works nicely because a Stri ng variable can store many 
characters at once and the next method can read many characters at once. 



But in Listing 6-4, you're not interested in reading several characters. 
You expect the user to type one letter — either y or n. So you don't create 
a Stri ng variable to store the user's response. Instead, create a cha r 
variable — a variable that stores just one symbol at a time. 

The Java API doesn't have a next Char method. To read something suitable 
for storage in a cha r variable, you have to improvise. The code in Listing 6-4 
reads an entire string with the next method, then grabs the string's starting 
character with ch a r At ( 0 ) . So if the user types the word yes, several things 
happen: 

1. The next method gets yes from the keyboard. 

2. The cha rAt method grabs the letter y from the string yes. 

3. The letter y gets assigned to the variable re pi y. 




A Stri ng variable can contain many characters or just one character. But a 
Stri ng variable that contains only one character isn't the same as a char 
variable. No matter what you put in a Stri ng variable, Stri ng variables and 
char variables have to be treated differently. 
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6-4, the actual file-handling statements deserve some attention, 
'atements involve the use of classes, objects, and methods. Many of 
the meaty details about these things are in other chapters, like Chapters 7 
and 9. Even so, I can't do any harm by touching on some highlights right 
here. 



So, you can find a class in the Java language API named java.io.File. The 
statement 



File evidence = new Fi 1 e( "c : WcookedBooks . txt" ) ; 



creates a new object in the computer's memory. This object, formed from the 
java.io.File class, describes everything that the program needs to know 
about the disk file c:\coo kedBooks. txt. (In Java, when you want to indicate 
a backslash inside a double-quoted String literal, you use a double back- 
slash instead.) From this point on in Listing 6-4, the variable evidence refers 
to the disk file c:\coo kedBooks. txt. 



After you've got all this java.io.File stuff in your head, the only thing left 
to know is that the evidence object, being an instance of the java.io.File 
class, has a del ete method. (What can I say? It's in the API documentation.) 
When you call evidence. delete, the computer gets rid of the file for you. 

Variable declarations and blocks 

A bunch of statements surrounded by curly braces form a block. If you 
declare a variable inside a block, you generally can't use that variable outside 
the block. For instance, in Listing 6-4, you get an error message if you make 
the following change: 

do { 

out . pri nt( "Del ete evidence? (y/n) "); 
char reply = myScanner . next( ) .charAt(O) ; 
) while (reply != 'y' && reply != 'n'); 

i f ( repl y == 'y ' ) 

With the declaration char reply inside the loop's curly braces, no use of the 
name reply makes sense anywhere outside the braces. When you try to 
compile this code, you get three error messages — two for the reply words 
in while (reply != 'y' && reply != ' n '), and a third for the i f state- 
ment's reply. 
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So in Listing 6-4, your hands are tied. The program's first real use of the 
reply variable is inside the loop. But, to make that variable available after 
you have to declare reply before the loop. In this situation, you're 
eclaring the reply variable without initializing the variable. Very 
interesting! 



^/■RlBMX T° read more about variable initializations, see Chapter 4. To read more 
about blocks, see Chapter 5. 




Loops Made Painless 



I'll never forget the first time I played Clue. We bought the board game during 
a family vacation in Niagara Falls. (Niagara Falls?) Cousin Alan and I sat in the 
hotel room playing the game for hours on end. I scribbled complicated asser- 
tions in my little detective's notebook. 

At one point, I bluffed by suggesting three cards that I had in my hand. Alan 
took the bait and made an accusation that was wrong on all three counts. 
Because he'd lost the game, and because I was being so smug about it, he 
beat the living daylights out of me. It was heaven. If I had the chance, I'd do it 
all over again. 



Don't need no stinking counters 

The for loop in Listing 6-2 counts from 1 to 10. And its friend (the for loop in 
Listing 6-3) counts 1, 2, 3. This counting is very nice, but sometimes it's not 
the most natural way to think about a problem. Take, for instance, the listing 
of all possible accusations in the board game Clue. The suspects aren't num- 
bered from 1 to 6, and neither are the rooms or weapons. You can number 
all these things, but why bother with numbering when the programming 
language provides a simpler solution? 

Java's enhanced for loop lets you cycle through groups of things without cre- 
ating a counting variable. All you have to do is define the group. Listing 6-5 
shows you what to do. 



Listing 6-5: "I Accuse . . ." 

import static Java . 1 ang . System . out ; 

class Clue { 



enum Suspect {mustard, plum, green, 

peacock, scarlet, white) 
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enum Room {ballroom, kitchen, diningRoom, 
lounge, hall, study, library, 
bi 1 1 i ardRoom , conservatory ) ; 



enum Weapon {knife, candlestick, revolver, 
rope, leadPipe, wrench); 



public static void mainCString a r g s [ ] ) { 



for (Suspect mySuspect : Suspect. val ues( ) ) { 
for (Room myRoom : Room. val ues( ) ) { 

for (Weapon myWeapon : Weapon. val ues( ) ) { 

out . pri nt (my Suspect ) ; 
out . pri nt C " in the " ) ; 
out . pri nt (myRoom) ; 
out . pri nt C " with a " ) ; 
out . pri ntl n (my Weapon ) ; 

} 

} 

} 



Suspect killer = Suspect . peacock ; 
Room sceneOfTheCrime = Room. study; 
Weapon murderWeapon = Weapon . 1 eadPi pe ; 

out.println( ) ; 

out . pri ntC " I accuse " ) ; 

out . pri nt C ki Her); 

out . pri ntC " i n the " ) ; 

out . pri ntC sceneOfTheCrime ) ; 

out . pri nt C " with a " ) ; 

out . pri nt (murderWeapon ) ; 

out . pri ntl n C " . " ) ; 

) 

} 



The output of the code in Listing 6-5 has 324 lines, so I can't show it all to 
you. But the first several lines appear in Figure 6-7. First, you see Colonel 
Mustard's ballroom antics. Then you get Mustard's kitchen tricks. Later in the 
run, when all of Mustard's frolics are finished, you see the same possibilities 
for Professor Plum. 



Figure 6-7: 

The code in 
Listing 6-5 
starts 
running. 



mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 
mustard 



in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
in the 
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ballroom with a knife 



ballroom with 
ballroom with 
ballroom with 
ballroom with 
ballroom with 
kitchen with a 
kitchen with a 
kitchen with a 
kitchen with a 
kitchen with 
kitchen with 



< candlestick 
i revolver 

< rope 

i leadPipe 
I wrench 
kni f e 

candlestick 
revolver 
rope 
leadPipe 
wrench 



dmmgRoom with a knife 
dmmgRoom with a candlestick 
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Room loop is inside of the Suspect loop. Not only do you loop 
ugh all the rooms, but you loop through all the rooms six times — 
once for each of the six suspects. If I count them up, that makes 54 visits 
to various rooms. 



i>* The Weapon loop is inside of the Room loop. So every time you visit a 
room (and you visit a room 54 times), you go through all six of the 
hideous weapons. 

Like the code in Listing 6-3, this section's Clue program nests statements 
within other statements. In Listing 6-3, 1 nested switch statements inside a 
big for statement. But in the Clue program, I nest for statements inside of 
other for statements. It may look at bit tangled at first, but when you get 
used to it, nesting loop within loop is a really useful technique. 



Grouping things together 

Java provides lots of ways for you to group things together. In Chapter 11, 
you can group things into an array or a collection. In this chapter, you group 
things into an en urn type. (Of course, you can't group anything unless you can 
pronounce en urn. The word enum is pronounced ee-noom, like the first two 
syllables of the word enumeration.) 

Creating a complicated enum type isn't easy, but to create a simple enum type, 
just write a bunch of words inside a pair of curly braces. Listing 6-5 has three 
enum types. The names of the enum types are Suspect, Room, and Weapon. 

When you define an enum type, two important things happen: 

w You create values. 

Just as 13 and 151 are i nt values, mustard and pi urn are Suspect 
values. 

You can create variables to refer to those values. 

After the for loop in Listing 6-5, 1 declare a variable named killer. Just as 
i nt numGuesses declares a numGuesses variable is of type i nt, and 
just as Stri ng myTi tl e declares variable myTi tl e to be of type 
String, so Suspect killer declares variable ki 1 1 er to be of type 
Suspect. 

I declare int numGuesses in Listing 6-1, and I declare Stri ng myTi tie 
in Listing 4-6. 
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green, and so on. So in Listing 6-5, 1 give the killer variable the value 
pock. (At this point in the code, if I don't type the longer dotted 
e Suspect. peacock, the Java compiler gets confused.) 




In a similar way, I create variables sceneOf TheCri me and murderWeapon 
toward the end of Listing 6-5. Both of these variables have en urn types, 
and both are given appropriate values (values like Room . study and 
Weapon . 1 eadPi pe). 

In Listing 6-5, all the enum type declarations are outside of the ma i n method. 
(For example, the line that begins with enum Suspect is before the start of 
the ma i n method.) Java doesn't allow you to put an enum type declaration 
inside a method. That's because an enum type declaration is really a Java 
class in disguise. For more insight on enum types, see Chapter 9. 



Anatomy of an enhanced for loop 

The enhanced and un-enhanced for loops have a lot in common. Figure 6-8 
illustrates the point. 



Listing 6-2: for (int count = 1; count <= 10; count++) 



The type of 
value that a 
variable can 
have 



The name of 
the variable 



The range of values 
that variable takes 
on during execution 
of the loop 



Figure 6-8: 

Comparing 
for loops. 



Listing 6-5: 



i ii 1 i 1 

for (Suspect mySuspect : Suspect . values () ) 



In both kinds of loops, you define a variable. 

The loop in Listing 6-2 defines a variable named count. The loop in 
Listing 6-5 defines a variable named mySuspect. 

In both listings, the statements inside the loop refer to the newly defined 
variable. The loop in Listing 6-2 has the statement 



out . pri nt( count) 
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and the loop in Listing 6-5 has the statement 

out. print( my Suspect); 



if " 




jng successive iterations, the print in Listing 6-2 stands for 
print(l), out.print(2), and so on. During successive 
iterations, the print in Listing 6-5 stands for out . pri nt(mustard ), 
out.print(plum), and so on. 

In both kinds of loops, you declare the type of value that the variable 
can have. 

In Listing 6-2, the variable count must store an i nt value (-7, 0, 5, 15, 
and so on). In Listing 6-5, the variable my Suspect must refer to a 
Suspect value (mustard, pi urn, whi te, and so on). 

In fact, this declaring the type of value rule applies everywhere in Java — 
not only in for loops. Every Java variable belongs to one type or 
another. In Listing 6-1, the line 

int numGuesses = 0; 

declares that numGuesses must store an int value. The line goes on to 
say that, among all possible int values, the starting value for 
numGuesses is 0. Again in Listing 6-1, the line 

Scanner myScanner = new Scanner ( System . i n ) ; 

declares that myScanner must refer toaScanner object. Among all 
such objects, the starting value for myScanner is an object that gets 
keystrokes from the keyboard (from System . i n). 

In both kinds of loops, you specify a range of values. 

You specify the range of values that the variable takes on during the exe- 
cution of the loop. In Listing 6-2, you narrow the count variable's values 
to the numbers from 1 to 10. In Listing 6-5, you throw caution to the 
wind, and say that my Suspect gets to be every one of the items in 

Suspect . val ues ( ). 



You can apply va 1 ues ( ) to the name of any en urn type. In fact, to create an 
enhanced for loop with an en urn type, you have to use something like 
v a 1 u e s ( ) . The expression Suspect. values( ) stands for all the items you 
list in the declaration of the Suspect enum type. So, in the loop of Listing 6-5, 
mySuspect becomes musta rd, then pi urn, then green, and so on. 

When you apply val ues ( ) to the name of an enum type, you get an array of 
items belonging to that enum type. To read all about arrays, see Chapter 11. 
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In this part . . . 

M^& ve y° u rea d or heard anything about object-oriented 
¥ m programming? Sometimes, all the object-oriented 
programmers seem to belong to a little club. They have a 
secret handshake, a secret sign, and a promise not to reveal 
object-oriented programming concepts to any outsiders. 
Well, the secrecy is ending. In this part, I take all the mys- 
tery out of object-oriented programming. I introduce the 
concepts step by step and illustrate each concept with a 
Java program or two. 




Chapter 7 



Classes and Objects 



In This Chapter 

Thinking like a real object-oriented programmer 
Passing values to and from methods 
Hiding details in your object-oriented code 




ZM s a computer book author, I've been told this over and over again — 
r • I shouldn't expect people to read sections and chapters in their logical 
order. People jump around, picking what they need and skipping what they 
don't feel like reading. With that in mind, I realize that you may have skipped 
Chapter 1. If that's the case, please don't feel guilty. You can compensate in 
just sixty seconds by reading the following information from Chapter 1: 

Because Java is an object-oriented programming language, your primary 
goal is to describe classes and objects. A class is the idea behind a certain 
kind of thing. An object is a concrete instance of a class. The programmer 
defines a class, and from the class definition, the computer makes individual 
objects. 

Of course, you can certainly choose to skip over the 60-second summary 
paragraph. If that's the case, you may want to recoup some of your losses. 
You can do that by reading the following two-word summary of Chapter 1: 

Classes; objects. 



Part III: Working with the Big Picture: Object-Oriented Programming 



Defining a Class (What It Means 
^QfiMGUccount) 



What distinguishes one bank account from another? If you ask a banker this 
question, you hear a long sales pitch. The banker describes interest rates, 
fees, penalties — the whole routine. Fortunately for you, I'm not interested in 
all that. Instead, I want to know how my account is different from your 
account. After all, my account is named Barry Burd, trading as Burd Brain 
Consulting, and your account is named Jane Q. Reader, trading as Budding 
Java Expert. My account has $24.02 in it. How about yours? 

When you come right down to it, the differences between one account and 
another can be summarized as values of variables. Maybe there's a variable 
named balance. For me, the value of balance is 24 . 02. For you, the value of 
balance is 55. 63. The question is, in writing a computer program to deal 
with accounts, how do I separate my balance variable from your balance 
variable? 

The answer is to create two separate objects. Let one ba 1 ance variable live 
inside one of the objects and let the other balance variable live inside the 
other object. While you're at it, put a name variable and an address variable 
in each of the objects. And there you have it. You've got two objects, and 
each object represents an account. More precisely, each object is an instance 
of the Account class. (See Figure 7-1.) 



Figure 7-1: 

Two objects. 



An instance of the Account class Another instance of the Account class 



name 
address 
balance 


Barry 




222 Cyberspace Lane 






24.02 





name 
address 


Jane 


111 Consumer Street 




balance 


55.63 



So far, so good. But you still haven't solved the original problem. In your com- 
puter program, how do you refer to my balance variable, as opposed to your 
balance variable? Well, you have two objects sitting around, so maybe you 
have variables to refer to these two objects. Create one variable named 
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myAccount and another variable named yowAccount. The myAccount variable 
refers to my object (my instance of the Account class) with all the stuff that's 
To refer to my balance, write 



myAccount . bal ance 
To refer to my name, write 

myAccount . name 

Then yourAccount. bal ance refers to the value in your object's balance 
variable, and yourAccount .name refers to the value of your object's name 
variable. To tell the computer how much I have in my account, you can write 



myAccount . ba 1 ance = 24.02; 


To display your name on the screen, you can 


write 


out. println(yourAccount. name) ; 




These ideas come together in Listings 7-1 anc 


I 7-2. 


Listing 7-1 : What It Means to Be an Account 


class Account { 
String name; 
String address; 
double balance; 

) 







Listing 7-2: Dealing with Account Objects 



import static java . 1 ang . System. out ; 

class UseAccount { 

public static void main(String args[]) ( 
Account myAccount; 
Account yourAccount; 

myAccount = new AccountO; 
yourAccount = new AccountO; 

myAccount . name = "Barry Burd" ; 

myAccount . address = "222 Cyberspace Lane"; 

myAccount . bal ance = 24.02; 



(continued) 
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yourAccount . name = "Jane Q. Public"; 
yourAccount . address = "111 Consumer Street" 
yourAccount . bal ance = 55.63; 

out. pri nt ( my Account. name) ; 

out.printC ("); 

out . pri nt (my Account .address ) ; 

out.printC) has $"); 

out. pri nt ( my Account. balance); 

out . pri ntl n ( ) ; 

out. print(yourAccount. name); 

out.printC ("); 

out. print(yourAccount. address); 

out.printC) has $"); 

out.print(yourAccount.balance); 



Taken together, the two classes — Account and UseAccount — form one 
complete program. The Account class defines what it means to be an 
Account. The code for the Account class tells you that each of the Account 
class's instances has three variables — name, address, and bal ance. This is 
consistent with the information in Figure 7-1. 

If you've been grappling with the material in Chapters 4 through 6, the code 
for class Account (Listing 7-1) may come as a big shock to you. Can you 
really define a complete Java class with only four lines of code (give or take a 
curly brace)? You certainly can. In fact, the Account class in Listing 7-1 is 
quite representative of what Java programmers think of when they think 
class. A class is a grouping together of existing things. In the Account class of 
Listing 7-1, those existing things are two Stri ng values and a doubl e value. 

The code in Listing 7-2 defines the UseAccount class. The code needs a mai n 
method, and every method has to be in one class or another. So put the main 
method in a class named UseAccount. This main method has variables of its 

own — yourAccount and myAccount. 



Declaring Variables and creating objects 

In a way, the first two lines inside the mai n method of Listing 7-2 are mislead- 
ing. Some people read Account yourAccount as if it's supposed to mean, 
"yourAccount is an Account," or "The variable yourAccount refers to an 
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instance of the Account class." That's not really what this first line means. 
Instead, the line Account yourAccount means, "If and when I make the vari- 
f Account refer to something, that something will be an instance of 
iunt class." So, what's the difference? 



The difference is, simply declaring Account yourAccount doesn't make the 
yourAccount variable refer to an object. All the declaration does is reserve 
the variable name yourAccount so that the name can eventually refer to an 
instance of the Account class. The creation of an actual object doesn't come 
until later in the code, when the computer executes new AccountO. 

Technically, when the computer executes new Account( ), you're creating an 
object by calling the Account class's constructor. I have more to say about 
that in Chapter 9. 



When the computer executes the assignment yourAccount = new 
Account( ), the computer creates a new object (a new instance of the 
Accountclass)and makes the variable yourAccount refertothatnew 
object. (It's the equal sign that makes the variable refer to the new object.) 
The situation is illustrated in Figure 7-2. 



After executing 
Account yourAccount; 



yourAccount 



After executing 
yourAccount = 

new Account (); 



yourAccount 



name 
address 












balance 





To test the claim that I made in the last few paragraphs, I added an extra line 
to the code of Listing 7-1. 1 tried to print yourAccount . name after declaring 

yourAccount, but before calling new Account( ). 
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Account myAccount; 
Account yourAccount; 




t.println(yourAccount.name) 



myAccount = new AccountO; 
yourAccount = new AccountO; 

When I tried to compile the new code, I got this error message: variable 
yourAccount might not have been i ni ti al i zed. So that settles it. 
Before you do new Account ( ), you can't print the name variable of an object; 
an object doesn't exist. 

When a variable has a reference type, simply declaring the variable isn't 
enough. You don't get an object until you call a constructor and use the key- 
word new. 

For information about reference types, see Chapter 4. 



Initializing a Variable 



In Chapter 4, 1 announce that you can initialize a primitive type variable as 
part of the variable's declaration. 

int wei ghtOf APerson = 150; 

You can do the same thing with reference type variables, such as myAccount 
and yourAccount in Listing 7-2. You can combine the first four lines in the 
listing's ma i n method into just two lines, like this: 

Account myAccount = new AccountO; 
Account yourAccount = new AccountO; 



If you combine lines this way, you automatically avoid thevariable might 
not have been i ni ti al i zed error that I describe in the previous section. 
Sometimes you find a situation in which you can't initialize a variable. But 
when you can initialize, it's usually a plus. 



Using Variables 

After you've bitten off and chewed the main method's first four lines, the rest 
of the code in Listing 7-2 is sensible and straightforward. You have three lines 
that put values in the myAccount object's variables, three lines that put 
values in the yourAccount object's variables, and four lines that do some 
printing. The program's output is shown in Figure 7-3. 
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Figure 7-3: 



lunji 



Listings 7-1 
and 7-2. 



12 



Con f i gur-a. t i on L i s t i ngs 0701-02 

(222 Cyberspace Lane) has $24.02 
blic (111 Consumer Street) has $55.63 
.pie ted . 



Compiling and Running 
More Than One Class 



Each program in Chapters 3 to 6 consists of a single class. That's great for a 
book's introductory chapters. But in real life, a typical program consists of 
hundreds or even thousands of classes. The program that spans Listings 7-1 
and 7-2 consists of two classes. Sure, having two classes isn't like having 
thousands of classes, but it's a step in that direction. 

In practice, most programmers put each class in a file of its own. When you 
create a program like the one in Listings 7-1 and 7-2, you create two files 
on your computer's hard drive. So the code that comes from this book's 
CD-ROM has two separate files — Account .java and UseAccount .java. 
(See Figure 7-4.) 



Figure 7-4: 

Two files in 
one project. 



File View 

Workspace 'Chapler07': 5 Projects 
+ IjJ) Listing0707 
- Ijg] Listings0701-02 

jTI Account, java 
JT1 UseAccount. java 

t fig ListingsO.703-04 

| Ig) Listings0705-06 

± H 



To run the code, just do what you do to run any old single-file program. 

1. Open the Chapter07 workspace. 

2. Set Li sti ngs0701 02 as the active project. 

3. Choose BuildOCompile Project. 

4. Choose BuildOExecute Project. 
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For details on compiling and running code that's copied from the 
CD-ROM, see Chapter 2. 

^^r^i^^a new program with two or more classes is also pretty easy. (All you 
have to do is flip back and forth a million times between this chapter and 
Chapter 3.) 



1. Follow Steps 1 through 7 in the typing your own code section of 
Chapter 3. 

With these steps, you create a new project. 

2. Follow Steps 8 through 1 1 (also in the typing your own code section of 
Chapter 3) to create the first of two or more classes. 

If you're experimenting with the code in Listings 7-1 and 7-2, this first 
class is named Account. 

3. Follow Steps 8 through 1 1 again to create another class. 

If you're experimenting with the code in Listings 7-1 and 7-2, this second 
class is named UseAccount. 

Repeat Steps 8 through 1 1 once for each of the classes in your Java 
program. 

4. Follow Steps 12 through 15 in that same section of Chapter 3. 

When you do, JCreator compiles and runs your program. 



When you work with several classes at once, you can easily get the following 
unfriendly message: NoSuchMethodError: main. You see this when you try 
to execute a class that has no ma i n method. For example, the Account class 
in Listing 7-1 has no ma i n method. If the Account class's code is the front- 
most code in JCreator's Editor pane, and you choose BuildOExecute File 
(instead of BuildOExecute Project) from JCreator's main menu, you get the 
dreaded NoSuchMethodError. To fix this, always make sure that your project 
has a class with amain method, and always choose BuildOExecute Project to 
run your code. 



Defining a Method urithin a Class 
(Displaying an Account) 



Imagine a table containing the information about two accounts. (If you have 
trouble imagining such a thing, just look at Table 7-1.) 



Chapter 7: Thinking in Terms of Classes and Objects 



DropBo 



Table 7-1 


Without Object-Oriented Programming 


■\ j/^ejget Address Balance 


BarryBurd 


222 Cyberspace Lane 24.02 


Jane Q. Public 


111 Consumer Street 55.63 



In Table 7-1, each account has three things — a name, an address, and a bal- 
ance. That's the way things were done before object-oriented programming 
came along. But object-oriented programming involved a big shift in thinking. 
With object-oriented programming, each account can have a name, an 
address, a balance, and a way of being displayed. 

In object-oriented programming, each object has its own built-in functional- 
ity An account knows how to display itself. A string can tell you whether it 
has the same characters inside it as another string. APrintStream instance, 
such as System . out, knows how to do pri ntl n. In object-oriented program- 
ming, each object has its own methods. These methods are little subpro- 
grams that you can call to have an object do things to (or for) itself. 

And why is this a good idea? It's good because you're making pieces of data 
take responsibility for themselves. With object-oriented programming, all the 
functionality that's associated with an account is collected inside the code 
for the Account class. Everything you have to know about a string is located 
in the file String.java. Anything having to do with year numbers (whether 
they have two or four digits, for instance) is handled right inside the Year 
class. So, if anybody has problems with your Account class or your Year 
class, he or she knows just where to look for all the code. That's great! 

So imagine an enhanced account table. In this new table, each object has 
built-in functionality. Each account knows how to display itself on the screen. 
Each row of the table has its own copy of a di spl ay method. Of course, you 
don't need much imagination to picture this table. I just happen to have a 
table you can look at. It's Table 7-2. 



Table 7-2 The Object-Oriented Way 



Name 


Address 


Balance 


Display 


Barry Burd 


222 Cyberspace Lane 


24.02 


out. print. . . . 


Jane Q. Public 


111 Consumer Street 


55.63 


out. print. . . . 



Part III: Working with the Big Picture: Object-Oriented Programming 



3Bocfe 



An account that displays itself 



-2, each account object has four things — a name, an address, a 
and a way of displaying itself on the screen. After you make the jump 
to object-oriented thinking, you'll never turn back. A program that imple- 
ments the ideas in Table 7-2 is shown in Listings 7-3 and 7-4. 



Listing 7-3: An Account Displays Itself 

import static Java . 1 ang . System . out ; 

class Account I 
String name; 
String address; 
double balance; 

void displayO { 

out . pri nt ( name ) ; 
out.printC ("); 
out . pri nt ( address ) ; 
out.printC) has $"); 
out . pri nt ( ba 1 ance ) ; 

} 

) 



Listing 7-4: Using the Improved Account Class 

class UseAccount ( 

public static void main(String args[]) { 
Account myAccount = new AccountO; 
Account yourAccount = new AccountO; 

myAccount . name = "Barry Burd" ; 

myAccount . address = "222 Cyberspace Lane"; 

myAccount . ba 1 ance = 24.02; 

yourAccount . name = "Jane Q. Public"; 
yourAccount . address = "111 Consumer Street"; 
yourAccount . bal ance = 55.63; 

myAccount. displ ay( ) ; 
Sy stem. out. pri ntl n O ; 
yourAccount . di spl ay ( ) ; 

) 

) 
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A run of the code in Listings 7-3 and 7-4 looks just like a run for Listings 7-1 
and 7-2. You can see the action in Figure 7-3. 

7-3, the Account class has four things in it — a name, an address, a 
_, and a di spl ay method. These things match up with the four 
columns in Table 7-2. So each instance of the Account class has a name, an 
address, a balance, and a way of displaying itself. The way you call these 
things is nice and uniform. To refer to the name stored in myAccount, you 
write 
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myAccount . name 



To get myAccount to display itself on the screen, you write 



myAccount . di spl ay ( ) 




The only difference is the parentheses. 

When you call a method, you put parentheses after the method's name. 



The display method's header 

Look again at Listings 7-3 and 7-4. A call to the display method is inside the 
UseAccount class's mai n method. But the declaration of the di spl ay 
method is up in the Account class. The declaration has a header and a body. 
(See Chapter 3.) The header has two words and some parentheses: 

The word void tells the computer that when the di spl ay method is 
called, the di spl ay method doesn't return anything to the place that 
called it. To see a method that does return something to the place that 
called it, see the next section. 

The word display is the method's name. Every method must have a 
name. Otherwise, you don't have a way to call the method. 

V The parentheses contain all the things you're going to pass to the 
method when you call it. When you call a method, you can pass infor- 
mation to that method on the fly. The di spl ay method in Listing 7-3 
looks strange because the parentheses in the method's header have 
nothing inside them. This nothingness indicates that no information is 
passed to the di spl ay method when you call it. For a meatier example, 
see the next section. 
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Think about sending someone to the supermarket to buy bread. When you 
do this, you say, "Go to the supermarket and buy some bread." (Try it at 
home. You'll have a fresh loaf of bread in no time at all!) Of course, some 
other time you send that same person to the supermarket to buy bananas. 
You say, "Go to the supermarket and buy some bananas." And what's the 
point of all this? Well, you have a method, and you have some on-the-fly 
information that you pass to the method when you call it. The method is 
named goToTheSupermarketAndBuySome. The on-the-fly information is either 
bread or bananas, depending on your culinary needs. In Java, the method 
calls would look like this: 

goToTheS u per market And Buy Some ( bread ) ; 
goToTheSuperma rketAndBuy Some ( bananas ) ; 

The things in parentheses are called parameters or parameter lists. With para- 
meters, your methods become much more versatile. Instead of getting the 
same thing each time, you can send somebody to the supermarket to buy 
bread one time, bananas another time, and birdseed the third time. When 
you call your goToTheSupermarketAndBuySome method, you decide right 
there and then what you're going to ask your pal to buy. 

And what happens when your friend returns from the supermarket? "Here's 
the bread you asked me to buy," says your friend. As a result of carrying out 
your wishes, your friend returns something to you. You make a method call, 
and the method returns information (or a loaf of bread). 

The thing returned to you is called the method's return value. The general 
type of thing that was returned to you is called the method's return type. 
These concepts are made more concrete in Listings 7-5 and 7-6. 



Listing 7-5: An Account that Calculates Its Own Interest 

import static Java . 1 ang . System . out ; 

class Account { 
String name; 
String address; 
double balance; 

voi d di spl ay ( ) { 

out . pri nt ( name ) ; 
out.printC ("); 
out . pri nt ( address ) ; 
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out . printC " ) has $"); 
out . pri nt ( ba 1 ance ) ; 



double getlnterest( doubl e percentageRate) { 
return balance * percentageRate / 100.00; 

} 



Listing 7-6: Calculating Interest 

import static Java . 1 ang . System . out ; 

class UseAccount { 

public static void main(String args[]) { 
Account myAccount = new AccountO; 
Account yourAccount = new AccountO; 

myAccount . name = "Barry Burd" ; 

myAccount . address = "222 Cyberspace Lane"; 

myAccount . ba 1 ance = 24.02; 

yourAccount . name = "Jane Q. Public"; 
yourAccount . address = "111 Consumer Street"; 
yourAccount . bal ance = 55.63; 

myAccount . di spl ay ( ) ; 

out.printC plus $"); 

out . pri nt (myAccount . getlnterest( 5 . 00) ) ; 

out . pri ntl n ( " interest "); 

yourAccount. di spl ay (); 

double yourl nterestRate = 7.00; 
out.printC plus $"); 
double yourl nterestAmount = 

yourAccount . get Interest (your I nterestRate) ; 
out . pri nt (your I nterestAmount ) ; 
out . pri ntl n ( " interest "); 




The output of the code in Listings 7-5 and 7-6 is shown in Figure 7-5. In 
Listing 7-5, the Account class has a getl nterest method. This getl nterest 
method is called twice from the main method in Listing 7-6. The actual 
account balances and interest rates are different each time. 
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Listings 7-5 
and 7-6. 



Configuration: List ings0705-06 - j 2sdkl . 5 . 0 <Default> - <Default> 

(222 Cyberspace Lane) has $24.02 plus $1.2009999999999998 interest 
blic (111 Consumer Street) has $55.63 plus $3 8941000000000003 interest 



i>* In the first call, the balance is 24.02, and the interest rate is 5.00. The 

first call, myAccount .getlnterest(5.00), refers to the my Ac count 
object and all the variables inside it. (See Figure 7-6.) When this call is 
made, the expression bal a nee * percentageRate / 100.00 stands 
for 24.02 * 5.00/ 100.00. 

In the second call, the balance is 55.63, and the interest rate is 7.00. 

In the main method, just before this second call is made, the variable 
yourl nterestRate is assigned the value 7 .00. The call itself, 
yourAccount.getlnterest(yourlnterestRate), refers to 
the yourAccount object and all the variables inside it. (Again, see 
Figure 7-6.) So, when the call is made, the expression bal a nee * 
percentageRate / 100 . 00 stands for 55.63 * 7.00 / 100.00. 



Figure 7-6: 

My account 
and your 
account. 



An instance of the Account class Another instance of the Account class 



name 
address 
balance 


Barry 




222 Cyberspace Lane 


24.02 





name 
address 



Jane 



111 Consumer Street 



balance 55.63 



Account 
UseAccount 



myAccount 



yourAccount 



By the way, the main method in Listing 7-3 contains two calls to 
getlnterest. One call has the literal 5.00 in its parameter list; the other call 
has the variable yourl nterestRate in its parameter list. Why does one call 
use a literal and the other call use a variable? No reason. I just wanted to 
show you that you can do it either way. 
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pk at the getl interest method's header. (As you read the explana- 
e next few bullets, you can follow some of the ideas visually with the 
diagram in Figure 7-7.) 



Figure 7-7: 

Passing a 
value to a 
method. 



double getlnterest (double (percentageRate) ) { 



} 

Account 




return balance * (percentageRate) / 100.00; 



UseAccount 



out . println (myAccount . getlnterest ( (^Too) ) ) 



V The word double tells the computer that when the getlnterest 
method is called, the getlnterest method returns a doubl e value 
back to the place that called it. The statement in the getlnterest 

method's body confirms this. The statement says return balance * 
percentageRate / 100 . 00, and the expression ba 1 ance * 
percentageRate / 100 . 00 has type doubl e. (That's because all the 
things in the expression — ba 1 ance, percentageRate, and 100.00 — 
have type double.) 

When the getlnterest method is called, the return statement calcu- 
lates balance * percentageRate / 100 . 00 and hands the calcula- 
tion's result back to the code that called the method. 

The word getlnterest is the method's name. That's the name you use to 
call the method when you're writing the code for the UseAccount class. 

The parentheses contain all the things that you're going to pass to the 
method when you call it. When you call a method, you can pass infor- 
mation to that method on the fly. This information is the method's 
parameter list. The getlnterest method's header says that the 
getlnterest method takes one piece of information and that piece of 
information must be of type double. 

double get!nterest(doubl e percentageRate) 
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Sure enough, if you look at the first calltogetlnterest (down in the 
useAccount class's ma i n method), that call has the number 5.00 in it. 
5 . 00 is a doubl e literal. When I call getl interest, I'm giving the 
lod a value of type doubl e. 



If you don't remember what a literal is, see Chapter 4. 

The same story holds true for the second call to getl interest. Down 
near the bottom of Listing 7-6, 1 call getl interest and feed the variable 
yourl nterestRate to the method in its parameter list. Luckily for me, 
I declared yourl nterestRate to be of type double just a few lines 
before that. 



When you run the code in Listings 7-5 and 7-6, the flow of action isn't from 
top to bottom. The action goes from main to getlnterest, then back to 
mai n, then back to get Interest, and finally back to mai n again. The whole 
business is shown in Figure 7-8. 



Returning a Value from the 
getlnterest method 

When the getl nterest method is called, the method executes the one state- 
ment that's in the method's body: a return statement. The return statement 
computes the value of bal a nee * percentageRate / 100 . 00. If ba 1 ance 
happens to be 24.02, and percentageRate is 5.00, the value of the expres- 
sion is 1 . 201 — around $1.20. (Because the computer works exclusively with 
0s and Is, the computer gets this number wrong by an ever so tiny amount. 
The computer gets 1.2009999999999998. That's just something that humans 
have to live with.) 

Anyway, after this value is calculated, the computer executes the return, 
which sends the value back to the place in m a i n where getlnterest was 
called. At that point in the process, the entire method call — 

myAccount . getl nterest ( 5 . 00 ) — takes on the value 1.2009999999999998. 
The call itself is inside a pri ntl n: 

out . pri ntl n (myAccount . getlnterest(5.00)); 

So the pri ntl n ends up with the following meaning: 

out. pri ntl n(l .2009999999999998) ; 

The whole process, in which a value is passed back to the method call, is 
illustrated in Figure 7-9. 
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Figure 7-8: 

The flow of 
control in 
Listings 7-5 
and 7-6. 



r class Account { 

\fada, yada, yada. 



double getlnterest (double percentageRate) { 
return balance * percentageRate / 100.00; 

} 



class UseAccount { 

public static void main (String args [ ] ) { 
Account myAccount = new Account ( ) ; 

new Account ( ) ; 



Account yourAccount 



myAccount . name = " 
myAccount . address 
myAccount . balance 



Bprry Burd" ; 

"222 Cyberspace Lane"; 
24 . 02 ; 



yourAccount . name 
yourAccount . address 
yourAccount . balance 

myAccount . display ( ) 

out.print(" plus $"|) 



Jane Q. Public"; 
= "111 Consumer Street", 
= 55.63; 



out.printf ! myAccount . getlnterest (5 . 00 ) I ); 



out . println ( " inter 
yourAccount . display 



st " ) ; 
0 ; 



double yourlnterest ^ate = 7.00; 
out.print(" plus $"); 
double yourlnterest Amount = 

! yourAccount .getlnterest (yourlnterestRate) 

out . print (yourlnterestAmount ) ; 
out . println ( " interest "); 
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Figure 7-9: 

A method 
call is an 
expression 
with a value. 



I double getlnterest (double percentageRate ) { 



returnC^alance * percentageRate / IOoToJ^ 




out .println (QnyAccount . getlnterest ( 5 . 00 JJ>) 



If a method returns anything, a call to the method is an expression with a 
value. That value can be printed, assigned to a variable, added to something 
else, or whatever. Anything you can do with any other kind of value, you can 
do with a method call. 



Making numbers look good 

Looking back at Figure 7-5, you may be concerned that the interest on my 
account is only $1.2009999999999998. Seemingly, the bank is cheating me out 
of 200-trillionths of a cent. I should go straight there and demand my fair 
interest. Maybe you and I should go together. We'll kick up some fur at that 
old bank and bust this scam right open. If my guess is correct, this is part of a 
big salami scam. In a salami scam, someone shaves little slices off millions of 
accounts. People don't notice their tiny little losses, but the person doing the 
shaving collects enough for a quick escape to Barbados (or for a whole truck- 
load of salami). 



But, wait a minute! Nothing is motivating you to come with me to the bank. 
Checking back at Figure 7-5, 1 see that you're way ahead of the game. 
According to my calculations, the program overpays you by 300-trillionths of 
a cent. Between the two of us, we're ahead by a hundred-trillionth of a cent. 
What gives? 

Well, because computers use 0s (zeros) and Is and don't have an infinite 
amount of space to do calculations, inaccuracies like the ones shown in 
Figure 7-5 are inevitable. The best that you can do is display numbers in a 
more sensible fashion. You can round the numbers and display only two 
digits beyond the decimal point, and some handy tools from Java's API 
(Application Programming Interface) can help. The code is shown in 
Listing 7-7, and the pleasant result is displayed in Figure 7-10. 
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Listing 7-7: Making Your Numbers Look Right 



ilnport 

ipBocfe 



ipRP-Li static ja va . 1 ang . System . out ; 
seAccount I 



public static void main(String args[]) I 

Account myAccount = new Account(); 

Account yourAccount = new AccountO; 

myAccount . bal ance = 24.02; 

yourAccount . bal ance = 55.63; 

double mylnterest = myAccount . get Interest ( 5 . 00 ) ; 

double yourlnterest = yourAccount . get Interest ( 7 . 00 ) 



out.printf( 
out.printf ( 
out.printf ( 
out.printf ( 
out.printf ( 



$%4.2f\n", mylnterest); 

$%5.2f\n", mylnterest); 

$%.2f\n", mylnterest); 

$%3.2f\n", mylnterest); 

$%.2f $%.2f", mylnterest, yourlnterest): 



Figure 7-10: 

Numbers 
that look 
like dollar 
amounts. 



$1.20 
$ 1.20 
$1.20 
$1.20 
$1.20 $3 



S'H 



Process completed . 




Before you can run the code in Listing 7-7, you have to put two classes into 
your JCreator project. One class is the code in Listing 7-7; the other class is 
an Account class, like the one in Listing 7-5. 



Listing 7-7 uses a handy method named printf. When you call pri ntf , you 
always put at least two parameters inside the call's parentheses. 

The first parameter is a format string. 

The format string uses funny looking codes to describe exactly how the 
other parameters are displayed. 

v* All the other parameters (after the first) are values to be displayed. 

Look at the last printf call of Listing 7-7. The first parameter's format string 
has two placeholders for numbers. The first placeholder (% . 2f) describes 
the display of my Interest. The second placeholder (another % . 2 f ) 
describes the display of yourlnterest. To find out exactly how these format 
strings work, see Figures 7-11 through 7-15. 



Part III: Working with the Big Picture: Object-Oriented Programming 



DBooks 



Figure 7-11: 

Using a 
format 
string. 



$,%4.2f\n; 



Display a dollar sign. 



Go to a new line. 



What the computer 
displays: 

$1.20 



Use at least four places 
to display a number 
and put two of these 

places to the right of the 
decimal point. 



"a number" is the second parameter 
(the value of mylnterest) 



Figure 7-12: 

Adding 
extra places 
to display a 
value. 



$,%5.2f\n; 



Display a dollar sign. 



Go to a new line. 



What the computer 
displays: 

$ 1.20 



Use at least five places 
to display a number 
and put two of these 

places to the right of the 
decimal point. 



Because mylnterest takes only four 
places, display mylnterest with 
an extra blank space. 



Figure 7-13: 

Displaying 
a value 
without 

specifying 
the exact 

number of 
places. 



" $ | %.2f\ ,n" 



Display a dollar sign. 



Goto a new line. 



What the computer 
displays: 

$1.20 



Use appropriately 
many places to display 
a number and put two of 
these places to the right 
of the decimal point. 



Chapter 7: Thinking in Terms of Classes and Objects 



DropBooks 



Figure 7-14: 

Specifying 
too few 
places to 
display a 
value. 



"$,%3.2f\n; 



Display a dollar sign. 



Go to a new line. 



What the computer 
displays: 

$1.20 



Use at least three places 
to display a number 
and put two of these 

places to the right of the 
decimal point. 



Three isn't enough, so the 
computer uses four places. 



Figure 7-15: 

Displaying 
more than 
one value 
with a 
format 
string. 



" £ 9- 



2f $% 



Display a - 
dollar sign. 



Display the value of the second 
parameter (mylnterest) 
with two of these places to the 
right of the decimal point. 



2f 



What the computer 
displays: 

$1.20 $3.89 



Display the value of the third 
parameter (yourlnterest) 
with two of these places to the 
right of the decimal point. 



Display a blank 
space and a dollar sign. 




For more examples using the pri ntf method and its format strings, see 
Chapters 8 and 9. For a complete list of options associated with the pri ntf 
method's format string, see the ja va . uti 1 . Formatter page of Java's API 
documentation. 

The format string in a pri ntf call doesn't change the way a number is stored 
internally for calculations. All the format string does is create a nice-looking 
bunch of digit characters that can be displayed on your screen. 
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Hiding Details With Accessor Methods 
Drop |j?8i Shouldn't Micromanaqe a 
Bank Tetter) 

Put down this book and put on your hat. You've been such a loyal reader that 
I'm taking you out to lunch! 

I've got just one problem. I'm a bit short on cash. Would you mind if, on the 
way to lunch, we stopped at an automatic teller machine and picked up a few 
bucks? Also, we have to use your account. My account is a little low. 

Fortunately, the teller machine is easy to use. Just step right up and enter 
your PIN. After entering your PIN, the machine asks which of several variable 
names you want to use for your current balance. You have a choice of 
bal ance324, myBal, currentBal ance, b$, BALANCE, as j 999, or 
conStanTinople. Having selected a variable name, you're ready to select a 
memory location for the variable's value. You can select any number between 
022FFF and 0555AA. (Those numbers are in hexadecimal format.) After you've 
configured the teller machine's software, you can easily get your cash. You 
did bring a screwdriver, didn't you? 



Good pwqtamminty 

When it comes to good computer programming practice, one word stands 
out above all others — simplicity. When you're writing complicated code, the 
last thing you want is to deal with somebody else's misnamed variables; con- 
voluted solutions to problems; or clever, last-minute kludges. You want a 
clean interface that makes you solve your own problems and no one else's. 

In the automatic teller machine scenario that I describe earlier, the big prob- 
lem is that the machine's design forces you to worry about other people's 
concerns. When you should be thinking about getting money for lunch, 
you're thinking instead about variables and storage locations. Sure, someone 
has to work out the teller machine's engineering problems. But the banking 
customer isn't the person to solve these problems. 




This section is about safety, not security. Safe code keeps you from making 
accidental programming errors. Secure code (a completely different story) 
keeps malicious hackers from doing intentional damage. 
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So this means that everything connected with every aspect of a computer 
program has to be simple. Right? Well, no. That's not right. Sometimes, to 

gs simple in the long run, you have to do lots of preparatory work 
The people who built the automated teller machine worked hard to 
make sure that the machine is consumer-proof. The machine's interface, with 
its screen messages and buttons, makes the machine a very complicated, but 
carefully designed, device. 



The point is that making things look simple takes some planning. In the case 
of object-oriented programming, one of the ways to make things look simple 
is to keep code outside a class from directly using variables defined inside 
the class. Take a peek at the code in Listing 7-1. You're working at a company 
that has just spent $10 million for the code in the Account class. (That's 
more than a million and a half per line!) Now your job is to write the 
UseAccount class. You would like to write 



myAccount . name=" Barry Burd"; 



but doing so would be getting you too far inside the guts of the Account 
class. After all, people who use an automatic teller machine aren't allowed to 
program the machine's variables. They can't use the machine's keypad to 
type the statement 

balance0nAccount29872865457 = 

balance0nAccount29872865457 + 1000000.00; 



Instead, they push buttons that do the job in an orderly manner. That's how a 
programmer achieves safety and simplicity. 

So, to keep things nice and orderly, you need to change the Account class 
from Listing 7-1 by outlawing statements such as the following: 



myAccount . name=" Barry Burd"; 



and 



out.print(yourAccount.balance); 



But, of course, this poses a problem. You're the person who's writing the 
code for the UseAccount class. If you can't write myAccount . name or 
yourAccount. balance, how are you going to accomplish anything at all? 
The answer lies in things called accessor methods. These methods are demon- 
strated in Listings 7-8 and 7-9. 
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Listing 7-8: Hide Those Variables 



oil a s s / 

d Books 



|1 ass^Account { 

ivate String name; 

'ivate String address; 

private double balance; 



public void setName( Stri ng n) { 
name = n; 

) 

public String getNameO { 
return name; 

) 

public void setAddress ( Stri ng a) { 
address = a; 

) 

public String getAddressC) { 
return address; 

) 

public void setBal ance(doubl e b) { 
balance = b; 

) 

public double getBalanceO { 
return balance; 



Listing 7-9: Calling Accessor Methods 

import static Java . 1 ang . System . out ; 

class UseAccount ( 

public static void main(String args[]) { 
Account myAccount = new AccountO; 
Account yourAccount = new AccountO; 

myAccount . setName( "Ba rry Burd" ) ; 

myAccount . setAddressC "222 Cyberspace Lane"); 

myAccount . setBal ance(24 . 02) ; 

yourAccount . setName( "Jane Q. Public"); 
yourAccount. setAddressC'lll Consumer Street"); 
yourAccount. setBalance (55. 63); 
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out. print ( my Ac count. get Name ()); 
out.printC ("); 

out . pri nt (my Account . getAddressC ) ) ; 
out.printC) has $"); 
out . pri nt (my Account . getBal ance( ) ) ; 
out . pri ntl n ( ) ; 

out . pri nt (yourAccount . get Name ( ) ) ; 

out.printC ("); 

out. print (yourAccount. getAddressC ) ) ; 
out.printC) has $"); 
out. print (yourAccount. getBal a nee ( ) ) ; 

) 

) 

A run of the code in Listings 7-8 and 7-9 looks no different from a run of 
Listings 7-1 and 7-2. Either program's run is shown in Figure 7-3. The big 
difference is that in Listing 7-8, the Account class enforces the carefully 
controlled use of its internal variables. 



DropBooks 



Public lives and private dreams: Making 
a Variable name Inaccessible 

Notice the addition of the word private in front of each of the Account class's 
variable declarations. The word private is a Java keyword. When a variable is 
declared to be private, no code outside of the class can make direct reference 
to that variable. So if you put myAccount . name="Barry Burd" in the 
UseAccount class of Listing 7-9, you get the error message name has 
private access in Account. 

Instead of referencing myAccount . name, the UseAccount programmer must 
call method myAccount . setName or method myAccount . getName. These 
methods, setName and getName, are called accessor methods, because they 
provide access to the Account class's name variable. (Actually, the term 
accessor method isn't formally a part of the Java programming language. It's 
just the term that people use for methods that do this sort of thing.) To zoom 
in even more, setName is called a setter method, and getName is called a 
getter method. (I bet you won't forget that terminology!) 

Another commonly used term for an accessor method is a bean method. The 
phrase bean method comes from the world of JavaBeans — a way of plugging 
Java programs into existing graphical user interface (GUI) environments. 
Because JavaBeans relies heavily on accessor methods, many people associ- 
ate accessor methods with the JavaBeans specification. 
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With the Pro version of JCreator, you don't have to type your own accessor 
methods. First you type a variable declaration like private String name. 

,JCreator Pro's menu bar, you choose ToolsOInsert Bean Methods, 
approve the defaults in a small dialog box, JCreator creates acces- 
sor methods and adds them to your code. 



Notice that all the setter and getter methods in Listing 7-8 are declared to be 
public. This ensures that anyone from anywhere can call these two methods. 
The idea here is that manipulating the actual variables from outside the 
Account code is impossible, but you can easily reach the approved setter 
and getter methods for using those variables. 

c?/m!!Sm\ T° reac l more about the publ i c and pri vate keywords, see Appendix B and 
Chapter 15. (Chapter 15 is on the CD-ROM.) 

Think again about the automatic teller machine. Someone using the ATM 
can't type a command that directly changes the value in his or her account's 
balance variable, but the procedure for depositing a million-dollar check is 
easy to follow. The people who build the teller machines know that if the 
check depositing procedure is complicated, plenty of customers will mess it 
up royally. So that's the story — make impossible anything that people 
shouldn't do and make sure that the tasks people should be doing are easy. 

\\V ^ Nothing about having setter and getter methods is sacred. You don't have to 
""""" write any setter and getter methods that you're not going to use. For 

instance, in Listing 7-8, 1 can omit the declaration of method getAddress, 
and everything still works. The only problem if I do this is that anyone else 
who wants to use my Account class and retrieve the address of an existing 
account is up a creek. 

When you create a method to set the value inabalance variable, you don't 
have to name your method setBalance. You can name it tuna Fi sh, or what- 
ever you like. The trouble is that the setVa ri abl ename convention (with 
lowercase letters in set and an uppercase letter to start the Variab 7 ename 
part) is an established stylistic convention in the world of Java programming. 
If you don't follow the convention, you confuse the kumquats out of other 
Java programmers. If your integrated development environment has drag- 
and-drop GUI design capability, you may temporarily lose that capability. 
(For a word about drag-and-drop GUI design, see Chapter 2.) 



^jftBEfl When you call a setter method, you feed it a value of the type that's being set. 
^/-*JL\ That's why, in Listing 7-9, you call your Account .setBalance(55.63) with a 
parameter of type doubl e. In contrast, when you call a getter method, you 
usually don't feed any values to the method. That's why, in Listing 7-9, you 
call yourAccount . getBal ance( ) with an empty parameter list. 
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Occasionally, you may want to get and set a value with a s i n g 1 e 
statement. To add a dollar to your account's existing balance, you write 

punt . setBal ance (yourAccount . getBal ance( ) + 1.00). 



DropBooKS 

Enforcing rules With accessor methods 



Go back to Listing 7-8 and take a quick look at the setName method. Imagine 
putting the method's assignment statement inside an i f statement. 

if ( ! n . equal s ( " " ) ) 
name=n ; 



Now, if the programmer in charge of the UseAccount class writes 
myAccount . setName( " " ), the call to setName doesn't have any effect. 
Furthermore, because the name variable is private, the following statement is 
illegal in the UseAccount class: 

myAccount . name=" " ; 



Of course, a call such as myAccount .setName ("Joe Schmoe") still works 
because "Joe Schmoe" doesn't equal the empty string " " . 

That's cool. With a private variable and an accessor method, you can prevent 
someone from assigning the empty string to an account's name variable. With 
more elaborate i f statements, you can enforce any rules you want. 
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Saving Time and Money: 

Reusing Existing Code 



In This Chapter 

Adding new life to old code 
Tweaking your code 

Making changes without spending a fortune 



■ m nee upon a time, there was a beautiful princess. When the princess 
turned 25 (the optimal age for strength, good looks, and fine moral 
character), her kind father brought her a gift in a lovely golden box. Anxious 
to know what was in the box, the princess ripped off the golden wrapping 
paper. 

When the box was finally opened, the princess was thrilled. To her surprise, 
her father had given her what she had always wanted — a computer program 
that always ran correctly. The program did everything the princess wanted 
and did it all exactly the way she wanted it to be done. The princess was 
happy, and so was her kind, old father. 

As time went on, the computer program never failed. For years on end, the 
princess changed her needs, expected more out of life, made increasing 
demands, expanded her career, reached for more and more fulfillment, jug- 
gled the desires of her husband and her kids, stretched the budget, and 
sought peace within her soul. Through all this, the program remained her 
steady, faithful companion. 

As the princess grew old, the program became old along with her. One 
evening, as she sat by the fireside, she posed a daunting question to the pro- 
gram. "How do you do it?" she asked. "How do you manage to keep giving the 
right answers, time after time, year after year?" 
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"Clean living," replied the program. "I swim twenty apps each day, I take C++ 
to Word off viruses, I avoid hogarithmic algorithms, I link Java in moderation, 
to bugs, I don't smoke to backup, and I never byte off more than I 
e." 



Needless to say, the princess was stunned. 



Defining a Class (What It Means 
to Be an Employee) 

Wouldn't it be nice if every piece of software did just what you wanted it to 
do? In an ideal world, you could just buy a program, make it work right away, 
plug it seamlessly into new situations, and update it easily whenever your 
needs change. Unfortunately, software of this kind doesn't exist. (Nothing of 
this kind exists.) The truth is, no matter what you want to do, you can find 
software that does some of it, but not all of it. 

This is one of the reasons why object-oriented programming has been so suc- 
cessful. For years, companies were buying prewritten code only to discover 
that the code didn't do what they wanted it to do. So what did the companies 
do about it? They started messing with the code. Their programmers dug 
deep into the program files, changed variable names, moved subprograms 
around, reworked formulas, and generally made the code worse. The reality 
was that if a program didn't already do what you wanted it to do (even if it 
did something ever so close to what you wanted), you could never improve 
the situation by mucking around inside the code. The best option was always 
to chuck the whole program (expensive as that was) and start all over again. 
What a sad state of affairs! 

With object-oriented programming, a big change has come about. At its heart, 
an object-oriented program is made to be modified. With correctly written 
software, you can take advantage of features that are already built-in, add 
new features of your own, and override features that don't suit your needs. 
And the best part is that the changes you make are clean. No clawing and dig- 
ging into other people's brittle program code. Instead, you make nice, orderly 
additions and modifications without touching the existing code's internal 
logic. It's the ideal solution. 



The last rtord on employees 

When you write an object-oriented program, you start by thinking about the 
data. You're writing about accounts. So what's an account? You're writing 
code to handle button clicks. So what's a button? You're writing a program to 
send payroll checks to employees. What's an employee? 
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In this chapter's first example, an employee is someone with a name and a 
job title. Sure, employees have other characteristics, but for now I stick to 
s. The code in Listing 8-1 defines what it means to be an employee. 



Listing 8-1 : What Is an Employee? 



import static ja va . 1 ang . System . out ; 

class Employee { 

private String name; 
private String jobTitle; 

public void setName( Stri ng nameln) { 
name = nameln; 

) 

public String getNameO { 
return name; 

) 

public void setJobTitle(String jobTitleln) { 
jobTitle = jobTitleln; 



public String getJobTi tl e ( ) 
return jobTitle; 



public void cutCheck(doubl e amountPaid) ( 

out . pri ntf ( " Pay to the order of %s ", name) 
out.pn'ntf ("(%s) ***$", jobTitle); 
out. pri ntf ( "%, . 2f \n" , amount Pa i d ) ; 



) 



According to Listing 8-1, each employee has seven features. Two of these fea- 
tures are fairly simple. Each employee has a name and a job title. 

And what else does an employee have? Each employee has four methods to 
handle the values of the employee's name and job title. These methods are 
set Name, get Name, setJobTi tl e, and get JobTi tl e. Methods like these 
{accessor methods) are explained in Chapter 7. 

On top of all that, each employee has a cutCheck method. The idea is that 
the method that writes payroll checks has to belong to one class or another. 
Because most of the information in the payroll check is customized for a par- 
ticular employee, you may as well put the cutCheck method inside the 
Empl oyee class. 
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For details about the pri ntf calls in the cutCheck method, see the section 
entitled "Cutting a check," later in this chapter. 
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Putting yow class to qood use 



The Empl oyee class in Listing 8-1 has no mai n method, so there's no starting 
point for executing code. To fix this deficiency, the programmer must write a 
separate program with amain method and use that program to create 
Empl oyee instances. (To find out how to compile two programs separately, 
see Chapter 7.) Listing 8-2 shows a class with amain method — one that puts 
the code in Listing 8-1 to the test. 



Listing 8-2: Writing Payroll Checks 

import j ava . uti 1 . Scanner ; 
import j ava . i o . Fi 1 e ; 
import j ava . i o . IOExcepti on ; 

class DoPayroll { 

public static void main(String args[]) 

throws IOException 

Scanner diskScanner = 

new Scanner(new Fi 1 e( " Empl oyeelnf o . txt" ) ) ; 

for (int empNum = 1; empNum <= 3; empNum++) ( 
payOneEmployee(diskScanner); 



static void payOneEmpl oyee(Scanner aScanner) { 
Employee anEmployee = new EmployeeO; 

an Em pi oyee.setNa me (aScanner. next LineO); 
an Empl oyee . setJobTi tl e( aScanner . next Li ne( ) ) ; 
anEmployee.cutCheck(aScanner.nextDouble()); 
aScanner. nextLineO; 

) 

} 



The DoPayrol 1 class in Listing 8-2 has two methods. One of the methods, 
ma in, calls the other method, payOneEmpl oyee, three times. Each time 
around, the payOneEmpl oyee method gets stuff from the Empl oyeel nf o . txt 
file and feeds this stuff to the Empl oyee class's methods. 
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Here's how the variable name anEmployee is reused and recycled: 



ipBoofe' 

obiec 



first time that payOneEmpl oyee is called, the statement 
ployee = new Empl oyee () makes an Empl oyee refer to a new 
object. 



V The second time that payOneEmpl oyee is called, the computer executes 
the same statement again. This creates a new incarnation of the 
anEmployee variable that refers to a brand-new object. 

i>* The third time around, all the same stuff happens again. A new 
an Empl oyee variable ends up referring to a third object. 



The whole story is pictured in Figure 8-1. 



Figure 8-1: 

Three calls 
to the 
payOne 
Employee 
method. 



An instance of the 
Employee class 



Another instance of 
the Employee class 



A third instance of 
the Employee class 



name 
jobTitle 


Barry 




CEO 





name 


Harriet 








jobTitle 


Captain 





Employee 
DoPayroll 

anEmployee 



jobTitle Exec 



anEmployee 



anEmployee 




Cutting a check 

Listing 8-1 has three pri ntf calls. Each pri ntf call has a format string 
(like " its) ***$") and a variable (like j obTi tl e). Each format string has a 
placeholder (like %s) that determines where and how the variable's value is 
displayed. 

For example, in the second pri ntf call, the format string has a %s place- 
holder. This % s holds a place for the jobTitle variable's value. According to 
Java's rules, the notation %s always holds a place for a string and, sure 
enough, the variable jobTi tl e is declared to be of type St ri ng in Listing 8-1. 
Parentheses and some other characters surround the %s placeholder, so 
parentheses surround each job title in the program's output. (See Figure 8-2.) 
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Figure 8-2: 

E5 




Configuration: List ings0801-02 

to the order of Barry Burd (CEO) ***SS.OOO 00 

" order of Harriet Ritter (Captain) ***S7,000 00 

order of Your Wame Here (Honorary Exec of the Day) 



j2sdkl.5.D <D=fault> 



•510.000.00 




Back in Listing 8-1, notice the comma inside the % , . 2f placeholder. The 
comma tells the program to use grouping separators. That's why, in Figure 8-2, 
you see $5,000.00, $7 , 000 . 00, and $10,000.00 instead of $5000.00, 
$7000. 00, and $10000.00. 

Grouping separators vary from one country to another. For instance, in 
France, to write the number one thousand (mille), you write 1 000,00. 
Java can Frenchify your number automatically with a statement like 

out.print(new Java. lit il .Formatter().format(java.util .Locale. 
FRANCE, "%,.2f" 100 0.00)). For details, see the API (Application 
Programming Interface) documentation for Java's Formatter and Local e 
classes. 



Working tfith bisk Files 
(A Brief Detour) 

In previous chapters, programs read characters from the computer's key- 
board. But the code in Listing 8-2 reads characters from a specific file. The 
file (named EmployeeInfo.txt) lives on your computer's hard drive. 

This Empl oyeel nf o . txt file is like a word processing document. The file can 
contain letters, digits, and other characters. But unlike a word processing 
document, the Empl oyeel nf o . txt file contains no formatting — no italics, 
no bold, no font sizes, nothing of that kind. 

The Empl oyeel nfo . txt file contains only ordinary characters — the kinds 
of keystrokes that you type while you play a guessing game from Chapters 5 
or 6. Of course, getting guesses from a user's keyboard and reading employee 
data from a disk file aren't exactly the same. In a guessing game, the program 
displays prompts, such as Enter an int from 1 to 10. The game pro- 
gram conducts a back-and-forth dialogue with the person sitting at the key- 
board. In contrast, Listing 8-2 has no dialogue. This DoPay rol 1 program 
reads characters from a hard drive and doesn't prompt or interact with 
anyone. 
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Most of this chapter is about code reuse. But Listing 8-2 stumbles upon an 
important idea — an idea that's not directly related to code reuse. Unlike the 
in previous chapters, Listing 8-2 reads data from a stored disk file, 
section, I take a short side trip to explore disk files. 



Storing data in a file 

The code in Listing 8-2 doesn't run unless you have some employee data sit- 
ting in a file. Listing 8-2 says that this file is Empl oyeel nf o . txt. So before 
running the code of Listing 8-2, 1 created a small Empl oyeel nf o . txt file. The 
file is shown in Figure 8-3; refer to Figure 8-2 for the resulting output. 



Figure 8-3: 

An 

Employee 
lnfo.txt file. 



EmployeeInfo.txt 


DoPayroll.java Cm 




Barry Burd 
CEO 

5000.00 

Harriet Ritter 

Captain 

7000 . 00 

Your Name Here 

Honorary Exec of the Day 

10000.00 



When you install JCreator from this book's CD-ROM, the computer copies my 
Empl oyee I nf o . txt file exactly where you need it — in the project directory 
for Listings 8-1 and 8-2. So you can run this section's code without worrying 
about the Empl oyeel nf o . txt file. 

Even though you're not worried about it, you may want to see the 
Empl oyee Info . txt file in JCreator's editor. Who knows? You may want to 
change some of the data in the file. Here's how you can bring the file into the 
Editor pane: 

1. With JCreator open, choose FileOOpen Workspace. 

An Open dialog box appears. 

2. In the Open dialog box, select Chapter08 . jew, and click Open. 
The Chapter08 workspace fills JCreator's File View pane. 

3. In the File View pane, right-click the Li sti ngs0801 02 project. 
A context menu appears. 
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4. In the context menu, select Show All Files. 



I— ^ ■ Som< 
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Some additional filenames appear under the Listings0801-02 branch 
e File View's tree. One of these other filenames is 

oyeel nf o . txt. 



5. In the File View's tree, double-click Empl oyeelnf o. txt. 

When you write your own code, you may need to create files like my 

Empl oyeelnfo .txt file. Here's how you do it: 

1. In the File View pane, right-click the name of a project. Then choose 
AddONew File from the context menu that appears. 

JCreator's File Wizard opens to the File Path tab. 

2. In the Name field, type the name of your new data file. 

You can type any name that your computer considers to be a valid file 
name. For this section's example, I used Empl oyeelnfo .txt, but other 
names, such as Employ eelnfo.dat, Empl oyeelnfo, or 
Employeesl23.01.dataFile, are fine. I try to avoid troublesome names 
(including short, uninformative names and names containing blank 
spaces), but the name you choose is entirely up to you (and your com- 
puter's operating system, and your boss's whims, and your customer's 
specifications). 

Always include a dot in File Path tab's Name field. If the filename has no 
extension, add a dot at the end of the name. For instance, to create a file 
named Employeelnfo (not Empl oyeel nf o . txt or Empl oyeel nf o . dat), 
type Employeelnfo. exactly as you see it here. If you don't type your 
own dot anywhere in the Name field, JCreator adds a default extension 
to the filename (turning Empl oyeelnfo into Empl oyeelnfo .Java). 

3. Click Finish. 

The filename appears in JCreator's File View pane. A tab with the new 
filename appears in JCreator's Editor pane. 

4. Type text in the Editor pane. 

To create this section's example, I typed the text shown in Figure 8-3. 
To create your own example, type whatever text your program needs 
during its run. 

This book's Web site has tips for readers who need to create data files with- 
out using JCreator. This includes instructions for Linux, Unix, and Macintosh 
environments. 
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any computer programming language, reading data from a file can 
You add extra lines of code to tell the computer what to do. 



Sometimes you can copy and paste these lines from other peoples' code. 
For example, you can follow the pattern in Listing 8-2: 



/* 

* The pattern in Listing 




3-2 


*/ 

import j ava . uti 1 . Scanner ; 
import java . i o. Fi 1 e; 
import java . i o. IOExcepti on; 


class SomeCl assName { 








public static void main(String args[]) 

throws IOExcepti on 1 

Scanner scannerName = 

new Scanner(new Fi 1 e( " SomeFi leName" ) ) ; 


//Some code goes here 




scannerName. nextlntC ) ; 
scannerName. next Do ubl e ( ) ; 
scannerName. next( ) ; 
scannerName. next Li ne( ) ; 




//Some code goes I 

} 

} 


7 


ere 





You want to read data from a file. You start by imagining that you're reading 
from the keyboard. Put the usual Scanner and next codes into your pro- 
gram. Then add some extra items from the Listing 8-2 pattern: 



Add two new import declarations — one for j a va . i o . Fi 1 e and another 

for java . i o . IOExcepti on. 

f* Type throws IOException in your method's header. 
V Type new File("") in your call to new Scanner. 

u* Take a file that's already on your hard drive. Type that filename inside 
the quotation marks. 

f* Take the word that you use for the name of your scanner. Reuse that 
word in calls to next, nextlnt, nextDoubl e, and so on. 
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Occasionally, copying and pasting code can get you into trouble. Maybe 
you're writing a program that doesn't fit the simple Listing 8-2 pattern. You 
,weak the pattern a bit. But in order to tweak the pattern, you need 
tand some of the ideas behind the pattern. 



That's how the next section comes to your rescue. The following section 
covers some of these ideas behind the pattern. 



Reading from a file 

In previous chapters, programs read characters from the computer's 
keyboard. These programs use things like Scanner, System . i n, and 
nextDoubl e — things defined in Java's API. The DoPay rol 1 program in 
Listing 8-2 puts a new spin on this story. Instead of reading characters from 
the keyboard, the program reads characters from the Empl oyeel nf o . txt 
file. The file lives on your computer's hard drive. 

To read characters from a file, you use some of the same things that help you 
read characters from the keyboard. You use Scanner, nextDoubl e, and other 
goodies. But in addition to these goodies, you have a few extra hurdles to 
jump. Here's a list: 

You need a new Fi 1 e object. To be more precise, you need a new 
instance of the API's File class. You get this new instance with code like 

new Fi 1 e( " Empl oyeelnfo . txt " ) 

The stuff in quotation marks is the name of a file — a file on your com- 
puter's hard drive. The file contains characters like those shown previ- 
ously in Figure 8-3. 

At this point, the terminology makes mountains out of molehills. Sure, 
I use the phrases "new Fi 1 e object" and "new Fi 1 e instance," but all 
you're doing is making new Fi 1 e( " Empl oyeel nf o . txt" ) stand for a 
file on your hard drive. After you shove new 

Fi 1 e( " Empl oyeel nf o . txt" ) into new Scanner, 

Scanner diskScanner = 

new Scanner(new FileCEmployeeInfo.txt")); 

you can forget all about the new Fi 1 e business. From that point on in 
the code, diskScanner stands for the Empl oyeelnfo. txt filename on 
your computer's hard drive. (The name diskScanner stands for a file on 
your hard drive just as, in previous examples, the name myScanner 
stands for the computer's keyboard.) 
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Creating a new Fi 1 e object in Listing 8-2 is like creating a new 
Empl oyee object later in the same listing. It's also like creating a new 
»ount object in the examples of Chapter 7. The only difference is that 
jEmpl oyee and Account classes are defined in this book's examples. 
The File class is defined in Java's API. 

When you connect to a disk file with new Scanner, don't forget the new 
File part. If you write new Scanner("EmployeeInfo.txt") without 
new File, the compiler won't mind. (Choosing BuildOCompile Project 
will give you a friendly looking Process completed message.) But when 
you run the code, you won't get anything like the results that you expect 
to get. 

You must refer to the Fi 1 e class by its full name — j a va . i o . Fi 1 e. 

You can do this with an import declaration as in Listing 8-2. 
Alternatively, you can clutter up your code with a statement like 

Scanner di skScanner = 

new Scanner(new java.io.FileCEmployeeInfo.txt")); 

You need a th rows IOExcepti on clause. Lots of things can go wrong 
when your program connects to Empl oyeelnf o . txt. For one thing, 
your hard drive may not have a file named EmployeeInfo.txt. For another, 
the file Empl oyeelnf o . txt may be in the wrong directory. To brace for 
this kind of calamity, the Java programming language takes certain pre- 
cautions. The language insists that when a disk file is involved, you 
acknowledge the possible dangers of calling new Scanner. 

You can acknowledge the hazards in several possible ways, but the sim- 
plest way is to useathrows clause. In Listing 8-2, the ma i n method's 
header ends with the words throws IOException. By adding these two 
words, you appease the Java compiler. It's as if you're saying "I know 
that calling new Scanner can lead to problems. You don't have to 
remind me." And, sure enough, adding throws IOExcepti on to your 
main method keeps the compiler from complaining. (Without this 
throws clause, you get an unreported excepti on error message.) 

For the full story on Java exceptions, read Chapter 12. In the meantime, 
add throws IOExcepti on to the header of any method that calls new 

Scanner(new Fi 1 e( . . .. 

You must refer to the IOExcepti on class by its full name — 

java . i o . IOExcepti on. 

You can do this with an i mport declaration as in Listing 8-2. 
Alternatively, you can enlarge the main method's throws clause: 

public static void main(String args[]) 

throws java . i o. IOExcepti on { 
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i>* You must pass the file scanner's name to the payOneEmpl oyee method. 

■— ^ ■ In Listing 7-5 in Chapter 7, the getlnterest method has a parameter 

JT\ f\ f\ L^h^^ed percentageRate. Whenever you call the getl interest method, 
' \^«hand an extra, up-to-date piece of information to the method. 
(You hand a number — an interest rate — to the method. Figure 7-7 
illustrates the idea.) 

The same thing happens in Listing 8-2. The payOneEmpl oyee method 
has a parameter named aScanner. Whenever you call the payOneEmpl oyee 
method, you hand an extra, up-to-date piece of information to the 
method. (You hand a scanner — a reference to a disk file — to 
the method.) 



if 1 




You may wonder why the payOneEmpl oyee method needs a parameter. After 
all, in Listing 8-2, the payOneEmpl oyee method always reads data from the 
same file. Why bother informing this method, each time you call it, that the 
disk file is still the Empl oyeel nf o . txt file? 

Well, there are plenty of ways to shuffle the code in Listing 8-2. Some ways 
don't involve a parameter. But the way that this example has arranged things, 
you have two separate methods — a mai n method and a payOneEmpl oyee 
method. You create a scanner once inside the mai n method and then use the 
scanner three times — once inside each call to the payOneEmpl oyee method. 

Anything that you define inside a method is like a private joke that's known 
only to the code inside that method. So, the di skScanner that you define 
inside the main method isn't automatically known inside the 
payOneEmpl oyee method. To make the payOneEmpl oyee method aware of 
the disk file, you pass di skScanner from the main method to the 
payOneEmpl oyee method. 

To read more about variables that you declare inside (and outside) of meth- 
ods, see Chapter 10. 



Who motfed my file} 



> 



If you installed JCreator from this book's CD-ROM, your MyProjects directory 
has a subdirectory named Listings080 1-02. That Listings080102 directory 
comes with files named Employee.java and DoPayroll.java — the code in 
Listings 8-1 and 8-2. The Li sti ngs0801 02 directory also contains the 
Empl oyee Info . txt file. That's good, because if the Empl oyeelnfo. txt file 
isn't where it belongs, the whole project doesn't run properly. Instead, you 
get a Fi 1 eNotFoundExcepti on. 
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In general, when you get a Fi 1 eNotFoundExcepti on, some file that your pro- 
gram needs isn't available to your program. This is an easy mistake to make, 
frustrating because to you, a file such as Empl oyeel nf o . txt may 
it's available to your program. But remember — computers are 
stupid. If you make a tiny mistake, the computer can't read between the lines 
for you. So if your Empl oyeel nf o . txt file isn't in the right directory on your 
hard drive or the filename is spelled incorrectly, the computer chokes when 
it tries to run your code. 



Sometimes you know darn well that an Empl oyeelnf o . txt (or 
whatever .xyz) file exists on your hard drive. But when you run your pro- 
gram, you still get a mean-looking Fi 1 eNotFoundExcepti on. When this hap- 
pens, the file is usually in the wrong directory on your hard drive. (Of course, 
it depends on your point of view. Maybe the file is in the right directory, but 
you've told your Java program to look for the file in the wrong directory.) 
When this happens, try copying the file to some other directories on your 
hard drive and rerunning your code. (Subdirectories of JCreator's My Projects 
directory are always good places to put files.) Stare carefully at the names 
and locations of files on your hard drive until you figure out what's wrong. 



Adding directory names to your filenames 

You can specify a file's exact location in your Java code. Code like new 

Fi 1 e ( "C : WProgram FilesWXinox Sof tware\\JCreatorV3 LEW 
MyProjectsWListings0801-02WEmployeeInfo.txt") looks really ugly, 
but it works. 

In the previous paragraph, notice the double backslashes in "C : WProgram 
FilesWXinox Software . . ." If you're a Windows MS-DOS user, you'd 
be tempted to write C WProgram FilesWinox Software with single 
backslashes. But in Java, the single backslash has its own special meaning. 
(For example, in Listing 7-7, \ n means to go to the next line.) So in Java, to 
indicate a backslash inside a quoted string, you use a double backslash 
instead. 

If you know where your Java program looks for files, you can worm your way 
from that place to the directory of your choice. For example, the code in 
Listing 8-2 normally looks for the Empl oyeelnf o . txt file in a directory 
named Listings0801-02. So as an experiment, go to the Listings0801 02 
directory and create a new subdirectory named dataFiles. Then move my 
Empl oyeelnf o . txt file to the new dataFiles directory. To read numbers 
and words from the file that you moved, modify Listing 8-2 with the code new 
Fi 1 e ( "data Fi 1 esWEmpl oyeel nf o . txt" ). 
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Reading a line at a time 



8-2, the payOneEmpl oyee method illustrates some useful tricks for 
ata. In particular, every scanner that you create has anextLine 
method. (You might not use this next Li ne method, but the method is avail- 
able nonetheless.) When you call a scanner's next Li ne method, the method 
grabs everything up to the end of the current line of text. In Listing 8-2, 
a call to next Li ne can read a whole line from the EmployeeInfo.txt file. 
(In another program, a scanner's next Li ne call may read everything the user 
types on the keyboard, up to the pressing of the Enter key.) 

Notice my careful choice of words — next Li ne reads everything up to the 
end of the current line. Unfortunately, what it means to read up to the end of 
the current line isn't always what you think it means. Intermingling next I nt, 
nextDoubl e, and nextLi ne calls can be messy. You have to watch what 
you're doing and check your program's output carefully. 

To understand all this, you need to be painfully aware of a data file's line 
breaks. Think of a line break as an extra character, stuck between one line of 
text and the next. Then imagine that calling nextLi ne means to read every- 
thing up to and including the next line break. 



Now take a look at Figure 8-4. 



i>* If one call to nextLi ne reads Barry Burd[ Li neBreak], the subsequent 
call to nextLi ne reads CEO[LineBreak]. 

V If one call to nextDoubl e reads the number 5000.00, the subsequent call 
to nextLine reads the [LineBreak] that comes immediately after the 
number 5000.00. (That's all the nextLi ne reads — a [Li neBreak] and 
nothing more.) 

If a call to nextLi ne reads the [ Li neBreak] after the number 5000.00, 
the subsequent call to nextLi ne reads Harriet Ri tter [ Li neBreak]. 

So after reading the number 5000.00, you need two calls to next Li ne in order 
to scoop up the name Harriet Ritter. The mistake that I usually make is to 
forget the first of those two calls. 




Look again at the file in Figure 8-3. For this section's code to work correctly, 
you must have a line break after the last 10000.00. If you don't, a final call to 
next Li ne makes your program crash and burn. The error message reads 

NoSuchEl ementExcepti on : No line found. 
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Figure 8-4: 

Calling 
nextDouble 
and 
nextLine. 



I Barry Burd |LineBreak| | 



jCEO |LineBreak| , 



- nextLine ( ' 



- nextLine ( 



I 5000 . 00 |LineBreak| | 



nextDouble ( ) - 



- nextLine ( ) 



|Harriet Ritter | LineBreak 1 1 



- nextLine ( ) 




I'm always surprised by the number of quirks that I find in each programming 
language's scanning methods. For example, the first next Li ne that reads 
from the file in Figure 8-3 devours Barry Burd[LineBreak] from the file. But 
that next Li ne call delivers Barry Burd (without any line break) to the run- 
ning code. So nextLi ne looks for a line break, and then nextLi ne loses the 
line break. Yes, this is a subtle point. And no, this subtle point hardly ever 
causes problems for anyone. 




If this business about nextDoubl e and nextLi ne confuses you, please don't 
put the blame on Java. Mixing input calls is delicate work in any computer 
programming language. And the really nasty thing is that each programming 
language approaches the problem a little differently. What you find out about 
next Li ne in Java helps you understand the issues when you get to know C++ 
or Visual Basic, but it doesn't tell you all the details. Each language's details 
are unique to that language. (Yes, it's a big pain. But because all computer 
programmers become rich and famous, the pain eventually pays off.) 



Defining Subclasses (What It Means 
to Be a Full-Time Employee or 
a Part-lime Employee) 

This time last year, your company paid $10 million for a piece of software. 
That software came in the Empl oyee .class file. People at Burd Brain 
Consulting (the company that created the software) don't want you to know 
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about the innards of the software (otherwise, you may steal their ideas). So 
you don't have the Java program file that the software came from. (In other 
pu don't have Empl oyee . Java.) You can run the bytecode in the 
.class file. You can also read the documentation in a Web page 
named Employee.html. But you can't see the statements inside the 
Empl oyee . j ava program, and you can't change any of the program's code. 



Since this time last year, your company has grown. Unlike the old days, your 
company now has two kinds of employees: full-time and part-time. Each full- 
time employee is on a fixed, weekly salary. (If the employee works nights and 
weekends, then in return for this monumental effort, the employee receives a 
hearty handshake.) In contrast, each part-time employee works for an hourly 
wage. Your company deducts an amount from each full-time employee's pay- 
check to pay for the company's benefits package. Part-time employees, how- 
ever, don't get benefits. 

The question is, how can the software that your company bought last year 
keep up with the company's growth? You invested in a great program to 
handle employees and their payroll, but the program doesn't differentiate 
between your full-time and part-time employees. You have several options: 

i>* Call your next-door neighbor, whose 12-year-old child knows more about 
computer programming than anyone in your company. Get this uppity 
little brat to take the employee software apart, rewrite it, and hand it 
back to you with all the changes and additions your company requires. 

On second thought, you can't do that. No matter how smart that kid is, 
the complexities of the employee software will probably confuse the kid. 
By the time you get the software back, it'll be filled with bugs and incon- 
sistencies. Besides, you don't even have the Empl oyee . j a va file to hand 
to the kid. All you have is the Empl oyee .class file, which can't be read 
or modified with a text editor. (See Chapter 2.) Besides, your kid just 
beat up the neighbor's kid. You don't want to give your neighbor the sat- 
isfaction of seeing you beg for the whiz kid's help. 

Scrap the $10 million employee software. Get someone in your company 
to rewrite the software from scratch. 

In other words, say goodbye to your time and money. 

Write a new front end for the employee software. That is, build a piece of 
code that does some preliminary processing on full-time employees and 
then hands the preliminary results to your $10 million software. Do the 
same for part-time employees. 

This idea could be decent or spell disaster. Are you sure that the exist- 
ing employee software has convenient hooks in it? (That is, does the 
employee software contain entry points that allow your front-end 
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software to easily send preliminary data to the expensive employee soft- 
ware?) Remember, this plan treats the existing software as one big, 
olithic lump, which can become cumbersome. Dividing the labor 
een your front-end code and the existing employee program is diffi- 
cult. And if you add layer upon layer to existing black box code, you'll 
probably end up with a fairly inefficient system. 

Call Burd Brain Consulting, the company that sold you the employee 
software. Tell Dr. Burd that you want the next version of his software to 
differentiate between full-time and part-time employees. 

"No problem," says Dr. Burd. "It'll be ready by the start of the next fiscal 
quarter." That evening, Dr. Burd makes a discrete phone call to his next- 
door neighbor. . . . 

i>* Create two new Java classes named FullTimeEmployee and 

PartTimeEmployee. Have each new class extend the existing functionality 
of the expensive Empl oyee class. But have each new class define its own 
specialized functionality for certain kinds of employees. 

Way to go! Figure 8-5 shows the structure that you want to create. 







Employee 





Figure 8-5: 

The 
Employee 
class family 
tree. 




FullTimeEmployee 



PartTimeEmployee 



Creating a subclass 

In Listing 8-1, 1 define an Empl oyee class. I can use what I define in Listing 8-1 
and extend the definition to create new, more specialized classes. So in 
Listing 8-3, 1 define a new class — a Ful 1 TimeEmpl oyee class. 
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Listing 8-3: What Is a FullTimeEmployee? 
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P as^Full Ti meEmpl oyee extends Employee 

ivate double weekl ySal ary ; 
ivate double benef i tDeducti on ; 



public void setWeeklySal ary(doubl e weeklySal aryin ) { 
weeklySalary = weeklySal aryin ; 

) 

public double getWeeklySal ary ( ) { 
return weeklySalary; 

) 

public void setBenef itDeducti on(doubl e benef i tDedln ) 
benef i tDeducti on = benef i tDedln ; 

) 

public double getBenefi tDeducti on ( ) { 
return benef i tDeducti on ; 



public double f i ndPaymentAmount( ) { 

return weeklySalary - benef i tDeducti on ; 



} 



Looking at Listing 8-3, you can see that each instance of the Ful 1 Ti me 
Empl oyee class has two variables: weekl ySa 1 a ry and benef i tDeducti on. 
But are those the only variables that each Ful 1 Ti meEmpl oyee instance has? 
No, they're not. The first line of Listing 8-3 says that the Ful 1 Ti meEmpl oyee 
class extends the existing Empl oyee class. This means that in addition to 
having aweeklySalary and a benef i tDeducti on, each Ful 1 Ti meEmpl oyee 
instance also has two other variables: name and j obTi tl e. These two vari- 
ables come from the definition of the Empl oyee class, which you can find in 
Listing 8-1. 

In Listing 8-3, the magic word is the word extends. When one class extends an 
existing class, the extending class automatically inherits functionality that's 
defined in the existing class. So, the Ful 1 Ti meEmpl oyee class inherits the 
name and jobTi tl e variables. The Ful 1 Ti meEmpl oyee class also inherits all 
the methods that are declared in the Empl oyee class — setName, getName, 
setJobTitl e, getJobTitl e, and cutCheck. The Ful ITimeEmpI oyee class 
is a subclass of the Empl oyee class. That means the Empl oyee class is the 
superclass of the Ful 1 Ti meEmpl oyee class. You can also talk in terms of 
blood relatives. The Ful ITi meEmpl oyee class is the child of the Empl oyee 
class, and the Empl oyee class is the parent of the Ful ITi meEmpl oyee class. 



It's almost (but not quite) as if the Ful ITimeEmpI oyee class were defined by 
the code in Listing 8A. 
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Listing 8-4: Fake (But Informative) Code 
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port static Java . 1 ang . System . out ; 



Ful 1 Ti meEmpl oyee { 
private String name; 
private String jobTitle; 
private double weekl ySal ary ; 
private double benef i tDeducti on ; 

public void setName( Stri ng nameln) 
name = nameln; 

) 

public String getNameO { 
return name; 

) 



public void setJobTitle(String jobTitleln) { 
jobTitle = jobTitleln; 

) 

public String getJobTi tl e ( ) { 
return jobTitle; 

) 

public void setWeeklySal ary(doubl e weeklySal aryln ) { 
weeklySalary = weeklySal aryln ; 

) 

public double getWeeklySal ary ( ) { 
return weeklySalary; 

) 

public void setBenef itDeducti on(doubl e benef i tDedln ) { 
benef i tDeducti on = benef i tDedln ; 

) 

public double getBenefi tDeducti on ( ) { 
return benef i tDeducti on ; 

) 

public double f i ndPaymentAmount( ) { 

return weeklySalary - benef i tDeducti on ; 

) 



public void cutCheck(doubl e amountPaid) I 

out . pri ntf ( " Pay to the order of %s ", name); 
out.printf("(%s) ***$", jobTitle); 
out . pri ntf ( "% , . 2f \n" , amount Pa i d ) ; 

) 

} 
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Why does the title for Listing 8-4 call that code fake? (Should the code feel 
insulted?) Well, the main difference between Listing 8-4 and the inheritance 
, in Listings 8-1 and 8-3 is this: A child class can't directly reference 
)te variables of its parent class. To do anything with the parent 
class's private variables, the child class has to call the parent class's acces- 
sor methods. Back in Listing 8-3, calling setName( " Ruf us " ) would be legal, 
but the code name = " Ruf us" wouldn't be. If you believe everything you read 
in Listing 8-4, you think that code in the Ful 1 Ti meEmpl oyee class can do 
name = " Ruf us". Well, it can't. (My, what a subtle point this is!) 

You don't need the Empl oyee. Java file on your hard drive to write code that 
extends the Empl oyee class. All you need is the file Empl oyee .class. 



Creating subclasses is habit-forming 

After you're accustomed to extending classes, you can get extend-happy. 
If you created a Ful 1 Ti meEmpl oyee class, you might as well create a 
Pa rtTi me Empl oyee class, as shown in Listing 8-5. 



Listing 8-5: What Is a PartTimeEmployee? 



class PartTimeEm 
private doub 


pi oyee extends Empl 

le hourlyRate; 


oyee { 




public void setHourlyR. 
hourlyRate = ratel 

) 


ate(doubl 
i ; 


e rateln) { 




public double getHourlyRate( ) { 
return hourlyRate; 

) 






public double f i ndPaymentAmount( i nt hours) { 
return hourlyRate * hours: 


) 

) 









Unlike the Ful 1 Ti meEmpl oyee class, Pa rtTi meEmpl oyee has no salary or 
deduction. Instead Pa rtTi meEmpl oyee has an hourl yRate variable. (Adding 
a numberOf HoursWorked variable would also be a possibility. I chose not to 
do this, figuring that the number of hours a part-time employee works will 
change drastically from week to week.) 
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ious section tells a story about creating subclasses. It's a good story, 
but it's incomplete. Creating subclasses is fine, but you gain nothing from 
these subclasses unless you write code to use them. So in this section, you 
explore code that uses subclasses. 

Now the time has come for you to classify yourself as either a type-F person 
or a type-P person. A type-F person wants to see the fundamentals. (The 
letter F stands for fundamentals.} "Show me a program that lays the princi- 
ples out in their barest, most basic form," says the type-F person. A type-F 
person isn't worried about bells and whistles. The bells come later, and the 
whistles may never come at all. If you're a type-F person, you want to see a 
program that uses subclasses, and then moves out of your way so you can 
get some work done. 

On the other hand, a type-P person wants practical applications. (The letter P 
stands for practical.} Type-P people need to see ideas in context; otherwise 
the ideas float away too quickly. "Show me a program that demonstrates the 
usefulness of subclasses," says the type-P person. "I have no use for your 
stinking abstractions. I want real-life examples, and I want them now!" 

Because I'm always aiming to please my reader, this section has two (count 
'em — two) examples that make use of the previous section's subclasses. 
Listing 8-6, which is for the type-F crowd, is lean and simple and makes good 
bedtime reading. On the other hand, Listing 8-7, which is for type-P fanatics, 
shows how subclasses fit into a useful context. 

So that's it. Choose your poison and read on. 



A program for the minimalist 

Listing 8-6 shows you a bare-bones program that uses the subclasses 

Ful 1 Ti meEmpl oyee and PartTimeEmpl oyee. Figure 8-6 shows the program's 

output. 



Listing 8-6: Use Subclasses and Then Leave Me Alone 

class DoPayrol 1 TypeF { 

public static void main(String args[]) { 

Ful ITimeEmpI oyee ftEmployee = new Ful 1 TimeEmpl oyee( ) ; 

(continued) 
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ftEmpl oyee. setName( "Barry Burd"); 

f tEmpl oyee . setJobTi tl e ( "CEO" ) ; 

f t Empl oyee. setWeekly Salary (5000. 00) ; 

f tEmpl oyee . set Ben ef i tDeducti on ( 500 . 00 ) ; 

ftEmployee.cutCheck(ftEmployee.findPaymentArriount()); 

System, out. printlnO; 

PartTimeEmpl oyee ptEmployee = new PartTimeEmpl oyee( ) ; 

ptEmployee.setNameC Steve Surace") ; 
p tEmpl oyee. setJobTi tl e( "Driver " ) ; 
p tEmpl oyee .setHourlyRate(7.53); 

p tEmpl oyee . cutCheck( p tEmpl oyee.findPaymentAmount(lO)) 



Figure 8-6: 

The output 
of the 
program in 
Listing 8-6. 



Configuration: Listing0806 - : 2sdkl 

Pay to the order of Barry Burd (CEO) «»*S4.S00.00 

Pay to the order of Steye Surace (Driver) ***$75.30 



To understand Listing 8-6, you need to keep an eye on three classes: Empl oyee, 
Ful 1 Time Empl oyee, and PartTimeEmpl oyee. (For a look at the code that 
defines these classes, see Listings 8-1, 8-3, and 8-5.) 

The first half of Listing 8-6 deals with a full-time employee. Notice how so 
many methods are available for use with the f tEmpl oyee variable. For 
instance, you can call f tEmpl oyee . set Weekly Sal a ry because ftEmployee 
has type Ful 1 TimeEmpl oyee. You can also call ftEmpl oyee . setName 
because the Ful 1 Ti meEmpl oyee class extends the Empl oyee class. 

Because cutCheck is declared in the Empl oyee class, you can call ftEmpl oyee . 
cutCheck. But you can also call ftEmpl oyee . f i ndPaymentAmount because a 
f indPaymentAmount method is in the Ful 1 TimeEmpl oyee class. 

Making types match 

Look again at the first half of Listing 8-6. Take special notice of that last 
statement — the one in which the full-time employee is actually cut a check. 
The statement forms a nice, long chain of values and their types. You can see 
this by reading the statement from the inside out. 
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i>* Method f tEmpl oyee . f i ndPaymentAmount is called with an empty para- 
meter list (Listing 8-6). That's good, because the fi ndPaymentAmount 
od takes no parameters (Listing 8-3). 



fi ndPaymentAmount method returns a value of type double 
(again, Listing 8-3). 

V The doubl e value that f tEmpl oyee . f i ndPaymentAmount returns is 
passed to method f tEmpl oyee . cutCheck (Listing 8-6). That's good, 
because the cutCheck method takes one parameter of type double 
(Listing 8-1). 



For a fanciful graphic illustration, see Figure 8-7. 



Figure 8-7: 

Matching 
parameters. 




findPaymentAmount 



cutCheck 




No parameters 

No parameters 



double 



double 



Always feed a method the value types that it wants in its parameter list. 
The second half of the story 

In the second half of Listing 8-6, the code creates an object of type 
PartTimeEmpl oyee. Avariable of type PartTimeEmpl oyee can do 
some of the same things a Ful 1 Ti meEmpl oyee variable can do. But the 
Pa rtTi meEmpl oyee class doesn't have the setWeeklySalary and 
setBenef i tDeducti on methods. Instead, the PartTimeEmpl oyee class 
has the setHourlyRate method. (See Listing 8-5.) So, in Listing 8-6, the 
next-to-last line is a call to the setHourlyRate method. 



The last line of Listing 8-6 is by far the most interesting. On that line, 
the code hands the number 1 0 (the number of hours worked) to the 
f i ndPaymentAmount method. Compare this with the earlier call to 
f i ndPaymentAmount — the call for the full-time employee in the first 
half of Listing 8-6. Between the two subclasses, Ful 1 Ti meEmpl oyee and 
Pa rtTi meEmpl oyee, are two different f i ndPaymentAmount methods. The 
two methods have two different kinds of parameter lists: 
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i>* The Ful ITimeEmpI oyee class's fi ndPaymentAmount method takes no 
parameters (Listing 8-3). 



PartTimeEmpl oyee class's fi ndPaymentAmount method takes one 
parameter (Listing 8-5). 



This is par for the course. Finding the payment amount for a part-time 
employee isn't the same as finding the payment amount for a full-time 
employee. A part-time employee's pay changes each week, depending on the 
number of hours the employee works in a week. The full-time employee's pay 
stays the same each week. So the Ful 1 TimeEmpl oyee and PartTimeEmpl oyee 
classes both have f i ndPaymentAmount methods, but each class's method 
works quite differently. 



A program for the maximalist 

If you crave useful results and practical applications, you either skipped over 
the last listing or gritted your teeth while you read through it. Listing 8-7 
gives you the same information with a more practical point of view. Of 
course, there's a price. Listing 8-7 is longer and more complicated than the 
listing in the previous section. Oh, well! 



Listing 8-7: Big-Time Payroll Program 



import static java . 1 ang . System. out ; 

import j ava . uti 1 . Scanner ; 

import j ava . i o . Fi 1 e ; 

import j ava . i o . IOExcepti on ; 

class DoPayrol 1 TypeP { 

public static void main(String args[]) 

throws IOException 

Scanner diskScanner = 

new Scanner(new FileCEmpInfoNew.txt")); 
Scanner kbdScanner = new Scanner ( System . i n ) ; 

for (int empNum = 1; empNum <= 3; empNum++) { 
payOneFTEmployee(diskScanner); 



for (int empNum = 4; empNum <= 6; empNum++) I 
payOnePTEmployee(diskScanner, kbdScanner) ; 
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public static void payOneFTEmpl oyee(Scanner di skScanner ) { 
Ful 1 Ti meEmpl oyee employee = new Ful ITimeEmpI oyee( ) ; 



|em pi oyee.setName(di skScanner. nextLine()); 
employee.setJobTitle(di skScanner. nextLi ne( )) ; 
empl oyee. set We eklySalary(di skScanner. next Doubl e ( ) ) ; 
employee.setBenef it Deduct i on (di skScanner. nextDoubleO); 
di skScanner. nextLine(); 

di skScanner . nextLi ne( ) ; //Reads the dashed line that 



empl oyee . cutC heck ( empl oyee . f i nd Payment Amount ( ) ) ; 
out . pri ntl n ( ) ; 

) 

public static void payOnePTEmpl oyee 

(Scanner diskScanner, Scanner kbdScanner) I 

PartTimeEmpl oyee employee = new PartTimeEmpl oyee( ) ; 

empl oyee . set Name (di skScanner . nextLi ne( ) ) ; 
empl oyee . setJobTi tl e(di skScanner . nextLi ne( ) ) ; 
empl oyee . setHourly Rate (di skScanner . next Doubl e( ) ) ; 
di skScanner . nextLi ne( ) ; 

di skScanner . nextLi ne( ) ; //Reads the dashed line that 



out. print( "Enter "); 

out. pr i nt ( empl oyee.getNameO); 

out . pri nt( " ' s hours worked this week: "); 

int hours = kbdScanner. nextlnt( ) ; 

empl oyee.cutCheck( empl oyee.fi ndPaymentAmount ( hours ) ) ; 
out .pri ntl n ( ) ; 



For all its complexity, the code in Listing 8-7 still isn't a full-blown payroll pro- 
gram. It's a toy program, but it's a bit more realistic than the program in 
Listing 8-6. The code in Listing 8-7 writes checks for six employees — three 
full-time employees and three part-time employees. Calls to payOneFTEmpl oyee 
and payOnePTEmpl oyee make sure that each employee receives a check. 
Each of these payOneEmpl oyee methods reads data from a file and uses the 
data to fill the empl oyee object's variables with values. Figure 8-8 shows the 
file that I used to test Listing 8-7, and the resulting run is shown in Figure 8-9. 




// separates two employees 



// se 



parates two employees 
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Figure 8-8: 

Input forthe 
big-time 
payroll 
program. 



EmpInfoNew.txt DoPayrollTypeP. 



iBarry Burd 

DBodfe 



Harriet Ritter 
Captain 
7000 . 00 
700.00 

Your Name Here 

Honorary Exec of the Day 

10000.00 

200.00 

Steve Surace 

Driver 

7.53 

Bernard Smi th 
Messenger 

9.26 

Chris Apelian 
Computer Book Author 
3.54 



Figure 8-9: 

Paying your 
employees. 



General Output 






Conf iguration : Listing0807 - j 2sdkl 

Pay to the order of Barry Burd (CEO) ***$4 . 500 . 00 


5 . 0 <Def ault > - 


<Def£ 




Pay to the order of Harriet Ritter (Captain) ***$6, 300.0 


0 






Pay to the order of Your Name Here (Honorary Exec of the Day) ***S9,30Q 


GO 




Enter Steve Surace's hours worked this week: 10 
Pay to the order of Steve Surace (Driver) ***$75.30 








Enter Bernard Smith's hours worked this week; 15 

Pay to the order of Bernard Smith (Messenger) ***S 1 3 8 . 9 C 








Enter Chris Apelian's hours worked this week; 65 

Pay to the order of Chris Apelian (Computer Book Author) 


***$230 . 10 





Compared with its full-time cousin, the payOnePTEmpl oyee method pulls one 
extra idea out of its bag of tricks. When the time comes to get the number of 
hours the employee worked, the payOnePTEmpl oyee method doesn't consult 
a disk file. Instead, the method asks the user for live keyboard input. The 
thought here is that the disk file is where all the long-term information about 
employees lives. Because the number of hours an employee worked this 
week isn't long-term information, the payOnePTEmpl oyee method gets the 
user to enter this information on the fly. 

The payOnePTEmpl oyee method reads a name, a job title, and an hourly rate 
from the disk file. Then the method reads a number of hours from the key- 
board. Because the payOnePTEmpl oyee method reads data from two differ- 
ent sources, you pass two different scanners to the method. In the method's 
parameter list, you separate the two items with a comma. 
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Wouldn't you know it! Some knucklehead in the human resources department 
offered double pay for overtime to one of your part-time employees. Now 
word is getting around, and some of the other part-timers want double pay 
for their overtime work. If this keeps up, you'll end up in the poorhouse, so 
you need to send out a memo to all the part-time employees, explaining why 
earning more money is not to their benefit. 

In the meantime, you have two kinds of part-time employees — the ones who 
receive double pay for overtime hours and the ones who don't — so you 
need to modify your payroll software. What are your options? 

Well, you can dig right into the PartTimeEmpl oyee class code, make a 
few changes, and hope for the best. (Not a good idea!) 

f You can follow the previous section's advice and create a subclass of the 
existing Pa rtTi meEmpl oyee class. "But wait," you say. "The existing 
PartTimeEmpl oyee class already has a f i nd Payment Amount method. 
Do I need some tricky way of bypassing thisexistingfindPaymentAmount 
method for each double-pay-for-overtime employee?" 

At this point, you can thank your lucky stars that you're doing object- 
oriented programming in Java. With object-oriented programming, you 
can create a subclass that overrides the functionality of its parent class. 
Listing 8-8 has just such a subclass. 

Listing 8-8: Yet Another Subclass 

class PartTimeWithOver extends PartTimeEmpl oyee { 

public double f i ndPaymentAmount( i nt hours) { 

if(hours <= 40) { 

return getHourlyRate( ) * hours; 
} else { 

return getHourlyRate( ) * 40 + 

getHourlyRate( ) * 2 * (hours - 40); 

) 
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Figure 8-10 shows the relationship between the code in Listing 8-8 and other 
pieces of code in this chapter. In particular, PartTimeWithOver is a subclass 
lass. In object-oriented programming, a chain of this kind is not the 
nusual. In fact, as subclasses go, this chain is rather short. 



The PartTimeWithOver class extends the PartTimeEmpl oyee class, but 
Pa rtTi meWi thOver picks and chooses what it wants to inherit from the 
Pa rtTi meEmpl oyee class. Because Pa rtTi meWi thOver has its own declara- 
tion for the f i nd Payment Amount method, the PartTimeWi thOver class 
doesn't inherit a f i ndPaymentAmount method from its parent. (See 
Figure 8-11.) 

According to the official terminology, the Pa rtTi meWi thOver class overrides 
its parent class's f i ndPaymentAmount method. If you create an object from 
the Pa rtTi me Wi thOver class, that object has the name, j obTi tl e, 
hourly Rate, and cutCheckof the Pa rtTi meEmpl oyee class, but the object 
has the fi ndPaymentAmount method that's defined in Listing 8-8. 

If you need clarification on the stuff that you just read, look at the code in 
Listing 8-9. A run of that code is shown in Figure 8-12. 







Employee 





FullTimeEmployee 



PartTimeEmployee 



Figure 8-10: 

A tree of 
classes. 
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Figure 8-11: 

Method 
findPayment 
Amount isn't 
inherited. 



Employee 

^tigg8-l) 


name 

jobTitle 

cutCheck 






PartTimeEmployee 
(Listing 8-5) 


hourly-Rate 

f indPayment Amount 






PartTimeWithOver 
(Listing 8-8) 


f indPayment Amount 



Listing 8-9: Testing the Code from Listing 8-8 

class DoPayrol 1 TypeF { 

public static void main(String args[]) { 

Ful ITimeEmpI oyee ftEmployee = new Ful 1 TimeEmpl oyee( ) ; 

f tEmpl oyee . setName( "Ba rry Burd" ) ; 

f tEmpl oyee . setJobTi tl e ( "CEO" ) ; 

f tEmpl oyee. setWeekly Sal a ry( 5000. 00 ) ; 

f tEmpl oyee . set Ben ef i tDeducti on ( 500 . 00 ) ; 

f tEmpl oyee. cutCheck(f tEmpl oyee . f i ndPaymentAmount( ) ) ; 

PartTimeEmployee ptEmployee = new PartTimeEmpl oyee( ) ; 

p tEmpl oyee.setNameC Chris Ape! i an"); 

ptEmpl oyee . setJobTi tl e ( "Computer Book Author"); 

p tEmpl oyee .setHourlyRate(7.53); 

ptEmpl oyee. cutCheck( ptEmpl oyee . f i ndPaymentAmount(50) ) ; 

PartTimeWithOver ptoEmployee = new PartTimeWith0ver( ) ; 

ptoEmployee.setNa me ("Steve Surace"); 
ptoEmpl oyee . setJobTi tl e( "Dri ver" ) ; 
ptoEmpl oyee . setHourlyRate( 7 . 53 ) ; 
ptoEmpl oyee. cutCheck 

(ptoEmpl oyee.findPaymentAmount(50) ) ; 

) 

) 
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Configuration: Listmgs0808-09 - j 2sdkl . 5 . 0 <Default> 

order of Barry Burd (CEO) ***S4.500.00 
^ order of Chris Apelian (Computer Book Author) ***S376.50 
order of Steve Surace (Driver) ***S451 80 



The code in Listing 8-9 writes checks to three employees. The first employee 
is a full-timer. The second is one of those part-time employees who hasn't yet 
gotten wind of the overtime payment scheme. The third employee knows 
about the overtime payment scheme and demands a fair wage. 

With the subclasses, all three of these employees coexist in Listing 8-9. 
Sure, one subclass comes from the old PartTimeEmpl oyee class, but 
that doesn't mean you can't create an object from the PartTimeEmpl oyee 
class. In fact, Java is very smart about this. Listing 8-9 has three calls to the 
f i ndPaymentAmount method, and each call reaches out to a different version 
of the method. 

i>* In the first call, f tEmpl oyee . f i ndPaymentAmount, the f tEmpl oyee 
variable is an instance of the Ful 1 TimeEmpl oyee class. So the method 
that's called is the one in Listing 8-3. 

V In the second call, ptEmpl oyee . f i ndPaymentAmount, the ptEmpl oyee 
variable is an instance of the PartTimeEmpl oyee class. So the method 
that's called is the one in Listing 8-5. 

t<" In the third call, ptoEmpl oyee . f i ndPaymentAmount, the ptoEmpl oyee 
variable is an instance of the Pa rtTimeWi thOver class. So the method 
that's called is the one in Listing 8-8. 

This code is fantastic. It's clean, elegant, and efficient. With all the money that 
you save on software, you can afford to pay everyone double for overtime 
hours. (Whether you do that or keep the money for yourself is another 
story.) 
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In This Chapter 

Defining constructors 
Using constructors in subclasses 
Using Java's default constructor features 
Constructing a simple GUI 



s. Jennie Rebekah Burd 
121 Schoolhouse Lane 
Anywhere, Kansas 

Dear Ms. Burd, 

In response to your letter of June 21,1 believe I can say with complete assur- 
ance that objects are not created spontaneously from nothing. Although I have 
never actually seen an object being created (and no one else in this office can 
claim to have seen an object in its moment of creation), I have every confi- 
dence that some process or other is responsible for the building of these inter- 
esting and useful thingamajigs. We here at ClassesAndObjects.com support the 
unanimous opinions of both the scientific community and the private sector on 
matters of this nature. Furthermore, we agree with the recent finding of a Blue 
Ribbon Presidential Panel, which concludes beyond any doubt that sponta- 
neous object creation would impede the present economic outlook. 

Please be assured that I have taken all steps necessary to ensure the safety 
and well being of you, our loyal customer. If you have any further questions, 
please do not hesitate to contact our complaint department. The depart- 
ment's manager is Mr. Blake Wholl. You can contact him by visiting our 
company's Web site. 

Once again, let me thank you for your concern, and I hope you continue to 
patronize ClassesAndObjects.com. 

Yours truly, 




Mr. Scott Brickenchicker 

The one who couldn't get on the elevator in Chapter 4 
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Oe fining Constructors (What It Means 
D r 0 pB OCk&tnperature ) 

Here's a statement that creates an object: 

Account myAccount = new AccountO; 

I know this works — I got it from one of my own examples in Chapter 7. 
Anyway, in Chapter 7, 1 say, "when the computer executes new AccountO, 
you're creating an object by calling the Account class's constructor." What 
does this mean? 

Well, when you ask the computer to create a new object, the computer 
responds by performing certain actions. For starters, the computer finds a 
place in its memory to store information about the new object. If the object 
has variables, the variables should eventually have meaningful values. 

So one question is, when you ask the computer to create a new object, can 
you control what's placed in the object's variables? And what if you're inter- 
ested in doing more than filling variables? Perhaps, when the computer cre- 
ates a new object, you have a whole list of jobs for the computer to carry out 
For instance, when the computer creates a new window object, you want the 
computer to realign the sizes of all the buttons in that window. 

Creating a new object can involve all kinds of tasks, so in this chapter, you 
create constructors. A constructor tells the computer to perform a new 
object's startup tasks. 



What is a temperature) 

"Good morning, and welcome to Object News. The local temperature in your 
area is a pleasant 73 degrees Fahrenheit." 

Each temperature consists of two things — a number and a temperature 
scale. The code in Listing 9-1 makes this fact abundantly clear. 

Listing 9-1 : The Temperature Class 

class Temperature I 

private double number; 
private ScaleName scale; 
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public TemperatureC ) { 

number = 0.0; 

scale = Seal eName . f ahrenhei t ; 



publ 

} 

publ 

} 

publ 

} 

publ 
) 

publ 

) 

publ 



ic Temperature(doubl e number) { 

this. number = number; 

scale = Seal eName . f ahrenhei t ; 



ic Temperature(Scal eName scale) { 

number = 0.0; 

thi s . seal e = seal e ; 



ic Temperature(doubl e number, ScaleName scale) { 

this. number = number; 
thi s . seal e = seal e ; 



ic void setNumber(doubl e number) 
this. number = number; 



ic double getNumberO 
return number; 



ic void setScal e ( Seal eName scale) { 
thi s . seal e = seal e ; 



public ScaleName getScaleO 
return scale; 

) 




At the top of the code in Listing 9-1 are two variables: number and scale. 
A number is just a doubl e value, such as 32 . 0 or 70 . 52. A scale is an enum 
value. I define the enum type Seal eName in Listing 9-2. 

For an introduction to enum types, see Chapter 6. 



Listing 9-2: The ScaleName enum Type 

enum ScaleName {Celsius, fahrenheit, kelvin, rankine}; 
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The code in Listing 9-1 also has the usual setter and getter methods 
(accessor methods for the number and seal e variables). 

^^b|^o^^ good reading on setter and getter methods (also known as accessor 
methods) see Chapter 7. 

On top of all that, Listing 9-1 has four other method-like looking things. Each 
of these method-like things has the name Temperature, which happens to be 
the same as the name of the class. None of these Temperature method-like 
things has a return type of any kind — not even void, which is the copout 
return type. 

Each of these method-like things is called a constructor. A constructor is like a 
method, except that a constructor has a very special purpose — creating 
new objects. 

Whenever the computer creates a new object, the computer executes the 
statements inside a constructor. 



What you can do With a temperature 

Listing 9-3 gives form to some of the ideas that I describe above. In Listing 
9-3, you call the constructors that are declared back in Listing 9-1. Figure 9-1 
shows what happens when you run all this code. 



Listing 9-3: Using the Temperature Class 



import static Java . 1 ang . System. out ; 






class UseTemperature { 






public static void main(String args[]) { 
final String format = "%5.2f degrees 


%s\n' 




Temperature temp = new TemperatureC ) 

temp . set Number ( 70 . 0 ) ; 

temp . set Seal e ( Seal eName . f ahrenhei t ) ; 

out.printfCformat, temp.getNumberO, 


temp . 


getScal e( ) ) ; 


temp = new Temperature(32.0) ; 

out.printfCformat, temp.getNumberO, 


temp . 


getScal e( ) ) ; 


temp = new Temperature(Scal eName. Celsius) ; 

out.printfCformat, temp . getNumber( ) , temp. 


getScal e( ) ) ; 


temp = new Temperature(2.73, Seal eName. kel vi n) ; 

out.printfCformat, temp . getNumber( ) , temp . getScal e( ) ) ; 

) 

) 
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Figure 9-1: 

Listina 9-3. 



Listing 9-3. 



Conf i 

00 degrees fahrenheit 
grees f ahrenhei t 
grees Celsius 
egrees kelvin 




In Listing 9-3, each statement of the kind 

temp = new Temperature(£> 1 ah ,b 1 ah ,b 1 ah ) ; 

calls one of the constructors from Listing 9-1. So, by the time the code in 
Listing 9-3 is done running, it creates four instances of the Temperature 
class. Each instance is created by calling a different constructor from 
Listing 9-1. 



Catting new Temperature (32.0): 
A case study 

When the computer executes one of the new Temperature statements in 
Listing 9-3, the computer has to decide which of the constructors in Listing 



9-1 to use. The computer decides 
parentheses) after the words new 
computer executes 


jy looking at the parameter list (the stuff in 
Temperature. For instance, when the 


temp = new Temperature(32 . ( 


)) : 





from Listing 9-3, the computer says to itself, "The number 32.0 in parentheses 
is a double value." One of the Temperature constructors in Listing 9-1 has 
just one parameter with type double. The constructor's header looks like 
this. 



public Temperature(doubl e number) 

"So, I guess I'll execute the statements inside that particular constructor." 
The computer goes on to execute the following statements: 

this. number = number; 

scale = Seal eName . f ahrenhei t ; 

As a result, you get a brand-new object, whose number variable has the value 
32.0, and whose scale variable has the value fahrenheit. 
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In the two lines of code, you have two statements that set values for the vari- 
ables number and seal e. Take a look at the second of these statements, 
a bit easier to understand. The second statement sets the new 
cal e variable to fahrenheit. You see, the constructor's parameter 
ouble number), and that list doesn't include a s c a 1 e value. So who- 
ever programmed this code had to make a decision about what value to use 
for the scale variable. The programmer could have chosen fahrenheit or 
eel si us, but she could also have chosen kel vi n or ranki ne. (This program- 
mer happens to live in New Jersey, in the United States, where people com- 
monly use the old Fahrenheit temperature scale.) 

Marching back to the first of the two statements, this first statement assigns 
a value to the new object's number variable. The statement uses a cute 
trick that you can see in many constructors (and in other methods that 
assign values to objects' variables). To understand the trick, take a look at 
Listing 9-4. The listing shows you two ways that I could have written the 
same constructor code. 



Listing 9-4: Two Ways to Accomplish the Same Thing 

//Use this constructor ... 

public Temperature(doubl e whatever) { 
number = whatever; 

scale = Seal eName . f ahrenhei t ; 



//... or use this constructor ... 

public Temperature(double number) { 
this. number = number; 

scale = Seal eName . f ahrenhei t ; 

) 

//... but don't put both constructors in your code. 

Listing 9-4 has two constructors in it. In the first constructor, I use two differ- 
ent names — number and whatever. In the second constructor, I don't need 
two names. Instead of making up a new name for the constructor's parameter, 
I reuse an existing name by writing t h i s . n umbe r. 

So here's what's going on in Listing 9-1: 

In the statement thi s . number = number, the name this. number refers 
to the new object's number variable — the variable that's declared near 
the very top of Listing 9-1. (See Figure 9-2.) 

i>* In the statement thi s . number = number, the word number (on its 
own, without this) refers to the constructor's parameter. (Again, see 
Figure 9-2.) 
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What's this all about? 



IpJTtTse'TTJuT c'ocre'contains a constructor — 
the first of the two constructors in Listing 9-4. 
The whatever parameter is passed a number 
like 32.0 for instance. Then the first statement in 
the constructor's body assigns that value, 
32 . 0,to the new object's number variable. The 
code works. But in writing this code, you had to 
make up a new name for a parameter — the 
name whatever. And the only purpose for this 
new name is to hand a value to the object's 
number variable. What a waste! To distinguish 
between the parameter and the number vari- 
able, you gave a name to something that was 
just momentary storage for the number value. 

Making up names is an art, not a science. I've 
gone through plenty of naming phases. Years 
ago, whenever I needed a new name for a 



parameter, I picked a confusing misspelling of 
the original variable name. (I'd name the para- 
meter something like numbr or nuhmber.) I've 
also tried changing a variable name's capital- 
ization to come up with a parameter name. (I'd 
use parameter names like Number or nUMBER.) 
In Chapter 8, I name all my parameters by 
adding the suffix Into their corresponding vari- 
able names. (The jobTi tl e variable matched 
up with the jobTi tl el n parameter.) None of 
these naming schemes works very well. I can 
never remember the quirky new names that I've 
created. The good news is that this parameter 
naming effort isn't necessary. You can give the 
parameter the same name as the variable. To 
distinguish between the two, you use the Java 
keyword this. 



class Temperature { 



private double (n umbe r); 
private ScaleName scale; 



Figure 9-2: 

What 
this. number 
and number 

mean. 



public Temperature (double (numben { 



-<3Th i s . n umb er^ = (number^; 
scale = ScaleName . fahrenheit ; 



In general, this .someName refers to a variable belonging to the object that 
contains the code. In contrast, plain old someName refers to the closest place 
where someName happens to be declared. In the statement thi s .number = 
number (Listing 9-1), that closest place happens to be the Temperature 
constructor's parameter list. 
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enum types as first-class citizens 



the code from this book's CD-ROM tells an interesting 
e project for this section's example contains three Java files: 
Temperature .Java (Listing 9-1), Seal eName .Java (Listing 9-2), and 
UseTemperature .Java (Listing 9-3). The big news in this trio is 
Seal eName. Java. Why does this wimpy little one-line enum type 
deserve to be in its own separate Java file? 



Well, two issues exist here, and both of them are important: 



i>* An enum type is a class in disguise. When the Java compiler gets hold of 
your enum declaration, the compiler immediately turns the enum type 
into a class: 



class ScaleName extends Enum ( 






//There's code here that I'm not showing 


to 


you 


Celsius = new Seal eName( "eel si us" , 0); 






fahrenheit = new ScaleName( "fahrenheit" , 


1) ; 




kelvin = new Seal eName( "kel vin" , 2); 






rankine = new Seal eName( "rankine" , 3); 






//There's code here that I'm not showing 


to 


you 


) 







This normally happens behind the scenes. So in previous examples 
(Listing 6-5, for instance), you don't have to think about it. But in most of 
this book's examples (and according to standard Java programming 
practice), each Java class lives in a .Java file all its own. Because 
ScaleName is a class, having a separate Seal eName. Java file makes 
perfect sense. 

Back in Listing 6-5, 1 stuffed three enum type declarations inside another 
class — a class named Clue. In Chapter 6, this doesn't seem unusual, but 
now you may be thinking, "A class can be nestled inside another class." 
Well, stop thinking that way. It's true that Java supports a feature called 
inner classes — classes defined within other classes. It's also true that 
this inner class feature allows you to define a Suspect enum type inside 
a CI ue class. What's not true is that novice Java programmers should 
use inner classes, except in the narrowly defined context of enum types. 
So in general, when you're tempted to put one class inside another, don't 
do it. 

The Seal eName enum type must be available to both the Temperature 
and the UseTemperature classes. In the first draft of this section's 
code, I put the Seal eName enum type declaration inside Listing 9-1. 
That was fine until I wrote the UseTemperature class (Listing 9-3). The 
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UseTemperature class refers to Seal eName. So in order to get at this 
Sea 1 eName thing that I'd tucked inside Listing 9-1, 1 had to put some 
cumbersome statements in Listing 9-3: 

Wmp . set Seal e( Temperature. Seal eName . f ahrenhei t ) ; 

temp = new Temperature (Temperature. Seal eName . eel si us ) ; 

temp = new Temperature 

(2.73, Temperature . Seal eName . kel vi n ) ; 

At this point, a little voice told me that it was easier to put the 
ScaleName en urn declaration in a file all its own. That way, both the 
Temperature and UseTemperature classes could refer to Sea 1 eName 
without any extra chains full of names and dots. 
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Some things neOer change 

Chapter 7 introduces the pri ntf method, and explains that each pri ntf call 
starts with a format string. The format string describes the way in which the 
other parameters are to be displayed. 

In previous examples, this format string is always a quoted literal. For 



instance, the first pr 


ntf call in 1 


listing 7-7 is 






out.printf ("$%4. 


2f\n", my I 


nterest ) ; 






In Listing 9-3, 1 break with tradition and begin the pri ntf call with a variable 
that I name format. 


out . pri ntf (format , temp.getNumberO 


, temp . getScal e( ) 


) ; 



That's okay as long as my format variable is of type String. And indeed, 
in Listing 9-3, the first variable declaration is 



final String format = "%5.2f degrees %s\n"; 

In this declaration of the format variable, take special note of the word 
final. This Java keyword indicates that the value of format can't be changed. 
If I add an additional assignment statement to Listing 9-3 

format = "%6 . 2f (%s ) \n" ; 

then the compiler barks back at me with a cannot assign a value to 
final vari abl e message. 
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When I write the code in Listing 9-3, the use of the final keyword isn't 
absolutely necessary. But the final keyword provides some extra protec- 

{hgn I initialize format to "%5 . 2f degrees %s\n", I intend to use this 
^ma t just as it is, over and over again. I know darn well that I don't 
to change the format variable's value. Of course, in a 10,000-line pro- 
gram, I can become confused and try to assign a new value to format some- 
where deep down in the code. So to prevent me from accidentally changing 
the format string, I declare the format variable to be final. It's just good, safe 
programming practice. 
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More Subclasses (Doing Something 
about the Weather) 

In Chapter 8, 1 make a big fuss over the notion of subclasses. That's the right 
thing to do. Subclasses make code reusable, and reusable code is good code. 
With that in mind, it's time to create a subclass of the Temperature class 
(which I develop in this chapter's first section). 



Bmldinq better temperatures 

After perusing the code in Listing 9-3, you decide that the responsibility for 
displaying temperatures has been seriously misplaced. Listing 9-3 has several 
tedious repetitions of the lines to print temperature values. A 1970s program- 
mer would tell you to collect those lines into one place and turn them into a 
method. (The 1970s programmer wouldn't have used the word method, but 
that's not important right now.) Collecting lines into methods is fine, but with 
today's object-oriented programming methodology, you think in broader 
terms. Why not get each temperature object to take responsibility for dis- 
playing itself? After all, if you develop a di spl ay method, you'll probably 
want to share the method with other people who use temperatures. So put 
the method right inside the declaration of a temperature object. That way, 
anyone who uses the code for temperatures has easy access to your di spl ay 
method. 

Now replay the tape from Chapter 8. "Blah, blah, blah . . . don't want to 
modify existing code . . . blah, blah, blah . . . too costly to start again from 
scratch . . . blah, blah, blah . . . extend existing functionality." It all adds up to 
one thing: 

Don't abuse it. Instead, reuse it. 
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So you decide to create a subclass of the Temperature class, which is 
defined in Listing 9-1. Your new subclass will complement the Temperature 
nctionality by having methods to display values in a nice, uniform 
he new class, TemperatureNi ce, is shown in Listing 9-5. 



Listing 9-5: The TemperatureNice Class 



import static ja va . 1 ang . System . out ; 

class TemperatureNice extends Temperature { 

public TemperatureNi ce( ) { 
super( ) ; 

) 

public TemperatureNi ce(doubl e number) { 
super(number ) ; 

) 

public TemperatureNi ce( Seal eName scale) { 
super(scal e) ; 

) 

public TemperatureNi ce(doubl e number, ScaleName scale) I 
super(number , scale); 

) 

publ i c void di spl ay ( ) { 

out. printf ( "%5. 2f degrees %s\n", 

getNumberO, getScaleO); 

) 

) 



In the di spl ay method of Listing 9-5, notice the calls to the Temperature 
class's getNumber and getScal e methods. Why do I need to do this? Well, 
inside the TemperatureNi ce class's code, any direct references to the 
number and seal e variables would generate error messages. It's true that 
every TemperatureNi ce object has its own number and scale variables. 
(After all, TemperatureNi ce is a subclass of the Temperature class, and 
the code for the Temperature class defines the number and seal e vari- 
ables.) But because number and seal e are declared to be private inside the 
Temperature class, only code that's right inside the Temperature class can 
directly use these variables. 

Don't put additional declarations of the number and scale variables inside 
the TemperatureNi ce class's code. If you do, you'll inadvertently create four 
different variables (two called number, and another two called scale). You'll 
assign values to one pair of variables. Then you'll be shocked that when dis- 
playing the other pair of variables, those values seem to have disappeared. 
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When an object's code contains a call to one of the object's own 
methods, you don't need to preface the call with a dot. For instance, 

: statement of Listing 9-5, the object calls its own methods with 

;r ( ) and get Sea 1 e ( ), not with someObject .getNumber( ) and 
somethi ngOrOther . getScal e( ). If going dotless makes you queasy, you 
can compensate by taking advantage of yet another use for the this key- 
word. Just write this.getNumberO and this.getScaleO in the last 
line of Listing 9-5. 



memoas, > 
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Constructors for subclasses 

By far, the biggest news in Listing 9-5 is the way the code declares construc- 
tors. The TemperatureNi ce class has four of its own constructors. If you've 
gotten in gear thinking about subclass inheritance, you'll wonder why these 
constructor declarations are necessary. Doesn't TemperatureNi ce inherit 
the parent Temperature class's constructors? No, subclasses don't inherit 
constructors. 

Subclasses don't inherit constructors. 

That's right. Subclasses don't inherit constructors. In one oddball case, a 
constructor may look like it's being inherited, but that oddball situation is a 
fluke, not the norm. In general, when you define a subclass, you need to 
declare new constructors to go with the subclass. 



I describe the oddball case (in which a constructor looks like it's being inher- 
ited) later in this chapter, in the section "The default constructor." 

So the code in Listing 9-5 has four constructors. Each constructor has the 
name TemperatureNice, and each constructor has its own, uniquely identifi- 
able parameter list. That's the boring part. The interesting part is that each 
constructor makes a call to something named super, which is a Java keyword. 

In Listing 9-5, super stands for a constructor in the parent class. 



The statement super () in Listing 9-5 calls the parameterless 
Temperature ( ) constructor that's in Listing 9-1. That parameterless 
constructor assigns 0 . 0 to the number variable and 

ScaleName.fahrenheitto the scale variable. 

f* The statement super(number, scale) in Listing 9-5 calls the construc- 
tor Temperature(doubl e number, ScaleName seal e) that's in 
Listing 9-1. In turn, the constructor assigns values to the number and 
seal e variables. 



V In a similar way, the statements super (number) and super(scale) in 
Listing 9-5 call constructors from Listing 9-1. 
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The computer decides which of the Temperature class's constructors is 
being called by looking at the parameter list after the word super. For 
when the computer executes 

number , scale ) ; 

from Listing 9-5, the computer says to itself, "The number and scale vari- 
ables in parentheses have types doubl e and Seal eName. But only one of the 
Temperature constructors in Listing 9-1 has two parameters with types 
double and S c a 1 e N a me . The constructor's header looks like this: 

public Temperature(doubl e number, ScaleName scale) 
So, I guess I'll execute the statements inside that particular constructor." 



Usinq ail this stuff 

In Listing 9-5, 1 define what it means to be in the TemperatureNi ce class. 
Now it's time to put this TemperatureNi ce class to good use. Listing 9-6 has 
code that uses TemperatureNi ce. 

Listing 9-6: Using the TemperatureNice Class 

class UseTemperatureNi ce { 

public static void main(String args[]) { 

TemperatureNice temp = new TemperatureNi ce( ) ; 

temp . set Number ( 70 . 0 ) ; 
temp.setScale(ScaleName.fahrenheit); 
temp . di spl ay ( ) ; 

temp = new TemperatureNice(32.0) ; 

temp . di spl ay ( ) ; 

temp = new TemperatureNi ceCScal eName .eel si us ) ; 

temp . di spl ay ( ) ; 

temp = new TemperatureNice(2.73, Seal eName. kel vi n) ; 

temp . di spl ay ( ) ; 

) 

) 

The code in Listing 9-6 is very much like its cousin code in Listing 9-3. The big 
differences are as follows: 
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i>* Listing 9-6 creates instances of the TemperatureNi ce class. That is, 
Listing 9-6 calls constructors from the TemperatureNi ce class, not the 



erature class. 



ng 9-6 takes advantage of the di spl ay method in the 
TemperatureNi ce class. So the code in Listing 9-6 is much more tidy 
than its counterpart in Listing 9-3. 

A run of Listing 9-6 looks exactly like a run of the code in Listing 9-3. The run 
is shown previously in Figure 9-1. 



The default constructor 

The main message in the previous section is that subclasses don't inherit 
constructors. So what gives with all the listings back in Chapter 8? In 
Listing 8-6, a statement says 

Ful 1 TimeEmpl oyee ftEmployee = new Ful ITimeEmpI oyee( ) ; 

But, here's the problem: The code defining Ful 1 Ti meEmpl oyee (Listing 8-3) 
doesn't seem to have any constructors declared inside it. So, in Listing 8-6, 
how can you possibly call the Ful 1 TimeEmpl oyee constructor? 

Here's what's going on. When you create a subclass and don't put any 
explicit constructor declarations in your code, then Java creates one 
constructor for you. It's called a default constructor. If you're creating the 
publ i c Ful 1 TimeEmpl oyee subclass, the default constructor looks like 
the one in Listing 9-7. 



Listing 9-7: A Default Constructor 

public Ful ITimeEmpI oyee( ) { 
super( ) ; 

) 

The constructor in Listing 9-7 takes no parameters, and its one statement 
calls the constructor of whatever class you're extending. (Woe be to you if 
the class that you're extending doesn't have a parameterless constructor.) 

You've just read about default constructors, but watch out! Notice one thing 
that this talk about default constructors doesn 't say: It doesn't say that you 
always get a default constructor. In particular, if you create a subclass and 
define any constructors yourself, Java doesn't add a default constructor for 
the subclass (and the subclass doesn't inherit any constructors, either). 
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So how can this trip you up? Listing 9-8 has a copy of the code from Listing 8-3, 
but with one constructor added to it. Take a look at this modified version of 

Ti meEmpl oyee code. 



Listing 9-8: Look, I Have a Constructor! 



class Ful 1 Ti meEmpl oyee extends Employee { 
private double weekl ySal a ry ; 
private double benef i tDeducti on ; 

public Ful 1 TimeEmpl oyee(doubl e weeklySal ary) { 
thi s .weeklySal a ry=weekly Sal ary ; 

} 

public void setWeeklySal ary(doubl e weeklySal aryln ) { 
weeklySalary = weeklySal aryln ; 

) 

public double getWeeklySal ary ( ) I 
return weeklySalary; 

) 

public void setBenef itDeducti on(doubl e benef i tDedln ) 
benef i tDeducti on = benef i tDedln ; 

) 

public double getBenefi tDeducti on ( ) ( 
return benef i tDeducti on ; 

) 

public double f i ndPaymentAmount( ) { 

return weeklySalary - benef i tDeducti on ; 



Using the Full TimeEmpl oyee code in Listing 9-8, a line like the following 
doesn't work: 

Ful 1 TimeEmpl oyee ftEmployee = new Ful ITimeEmpI oyee( ) ; 

It doesn't work because, having declared a Ful 1 Ti meEmpl oyee constructor 
that takes one double parameter, you no longer get a default parameterless 
constructor for free. 



So what do you do about this? If you need to declare any constructors, 
declare all the constructors that you're possibly going to need. Take the 
constructor in Listing 9-7 and add it to the code in Listing 9-8. Then the call 

new Ful 1 Ti meEmpl oyee ( ) starts working again. 
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rogram that I like to yank out and show people at Java parties, 
me, it surprises some of the veteran Java programmers.) The pro- 
gram is in Listings 9-9, 9-10, and 9-11. 



Listing 9-9: First Class Accomodations 



class MyClass { 

MyClassO { 

System . out . pri ntl n 

("MyClass constructor being called."); 

) 

) 



Listing 9-10: Second Class Accomodations 



class MySubclass extends MyClass I 

MySubclassO { 

System. out . pri ntl n 

("MySubclass constructor being called.") 

) 

) 



Listing 9-1 1 : What's My Output? 



class UseMyClasses { 

public static void main(String args[]) { 
new MySubcl ass ( ) ; 

) 

) 



So what's the output when you run the code in Listing 9-1 1? Huh? You think 
you get just one line of output? Sorry, that's not the way it works. The output 
that you get is shown in Figure 9-3. 



Figure 9-3: 

Surprise! 



Configuration: Li 

MyClass constructor being called. 
MySubclass constructor being called 

Process completed . 
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Under certain circumstances, Java automatically adds an invisible call to 
super, which is at the top of a constructor body. It's as if the MySubclass 
tor in Listing 9-10 really looks like this: 



MySuDcl ass ( ) I 
super( ) ; 

System .out . pri ntl n 

("MySubclass constructor being called."); 



In Listing 9-10, the invisible super call fires up the MyCl ass constructor, 
which prints the message MyCl ass constructor being called. This 
automatic addition of a super call is a tricky bit of business that doesn't 
appear often, so when it does appear, it may seem quite mysterious. 



A Constructor That Does More 

Here's a quote from someplace near the start of this chapter: "And what if 
you're interested in doing more than filling variables? Perhaps, when the 
computer creates a new object, you have a whole list of jobs for the com- 
puter to carry out." Okay, what if? 

This section's example has a constructor that does more than just assign 
values to variables. The example is in Listings 9-12 and 9-13. The result of 
running the example's code is shown in Figure 9-4. 



Listing 9-12: Defining a Frame 

import j ava . awt . Fl owLayout ; 
import j avax . swi ng . J Frame ; 
import j avax . swi ng . JButton ; 

class SimpleFrame extends JFrame { 

public Simpl eFrame( ) { 

setTi tl e ( "Don ' t click the button!"); 
setLayout(new Fl owLayout( ) ) ; 
setDefaultCl oseOperati on ( EXIT_0N_CL0SE ) ; 
add(new JButton (" Pani c" )) ; 
setSizeOOO, 100) ; 
setVisible(true) ; 

) 

) 
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Listing 9-13: Displaying a Frame 
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pass ShowAFrame 



lie static void mairHString args[]) I 
new Simpl eFrame( ) ; 





^> Don't click the button! 


□OB 


Figure 9-4: 


Panic 




Don't panic. 







The code in Listing 9-12 is made up mostly of calls to Java API (Application 
Programming Interface) methods. What this means to you is that the code 
contains lots of names that are probably unfamiliar to you. When I was first 
becoming acquainted with Java, I foolishly believed that knowing Java meant 
knowing all these names. Quite the contrary: These names are just carry-on 
baggage. The real Java is the way the language implements object-oriented 
concepts. 

Anyway, the code's anorexic main method has only one statement — a call to 
the constructor in the Simple Frame class. Notice how the object that this 
call creates isn't even assigned to a variable. That's okay, because the code 
doesn't need to refer to the object anywhere else. 

Up in the SimpleFrame class is only one constructor declaration. Far from 
just setting variables' values, this constructor calls method after method 
from the Java API. 



if 1 




All the methods called in the Si mple Frame class's constructor come from the 
parent class, J Frame. The J Frame class lives in the j avax . swi ng package. 
This package and another package, j a va . awt, have classes that help you put 
windows, images, drawings, and other gizmos on a computer screen. (In the 
java .awt package, the letters awt stand for abstract windowing toolkit.) 

For a little gossip about the notion of a Java package, see the sidebar entitled 
"Packages and import declarations." For lots of gossip about the notion of a 
Java package, see Appendix B and (on the CD-ROM) Chapter 15. 



In the Java API, what people normally call a window is an instance of the 

javax.swing.JFrame class. 
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|^ ^^Vc^^^j^^fff&t lets you lump classes into 
groups of classes. Each lump of classes 
is called a package. In the Java world, pro- 
grammers customarily give these packages long, 
dot-filled names. For instance, because I've reg- 
istered the domain name burdbrain.com, I may 
name a package com . burdbrai n . uti 1 s . 
textUti 1 s.The Java API is actually a big col- 
lection of packages. The API has packages with 
names like j ava . 1 ang, ja va . uti 1 , Java . 
awt, javax . swi ng, and so on. 

With this information about packages, I can 
clear up some of the confusion about import 
declarations. Any import declaration that 
doesn't use the word stati c must start with 
the name of a package and must end with either 
of the following: 

The name of a class within that package 

An asterisk (indicating all classes within 
that package) 

For example, the declaration 

import j ava . uti 1 . Scanner ; 

is valid because Java . uti 1 is the name of a 
package in the Java API, and Scanner is the 
name of a class in the Java, uti 1 package. 
The dotted name Java . uti 1 . Scanner is the 
fully qualified name of the Scanner class. 



ckages and import declarations 



A class's fully qualified name includes the name 
of the package in which the class is defined. 
(You can find out all this stuff about Java . uti 1 
and Scanner by reading Java's API documen- 
tation. For tips on reading the documentation, 
see Chapter 3 and this book's Web site.) 

Here's another example. The declaration 

import javax. swing.*; 

is valid because javax . swi ng is the name of 
a package in the Java API, and the asterisk 
refers to all classes in the javax . swi ng pack- 
age. With this i mport declaration at the top 
of your Java code, you can use abbreviated 
names for classes in the javax. swing 
package — names like JFrame, JButton, 
JMenuBar, JCheckBox, and many others. 

Here's one more example. A line like 

import javax.*; //Bad!! 

is nota valid import declaration. The Java API 
has no package with the one-word name 
javax. You may think that this line allows you to 
abbreviate all names beginning with javax 
(names like javax . swi ng . J Frame and 
j avax . sound .mi di ), but that's not the way 
the import declaration works. Because javax 
isn't the name of a package, the line import 
javax . * just angers the Java compiler. 



Looking at Figure 9-4, you can probably tell that an instance of the 
Si mpl e Frame class doesn't do much. The frame has only one button and, 
when you click the button, nothing happens. I made the frame this way to 
keep the example from becoming too complicated. Even so, the code in 
Listing 9-12 uses several API classes and methods. The setTi tl e, set Layout, 
setDef aul tCl oseOperati on, add, setSi ze, and setVi si bl e methods all 
belong to the javax. swi ng . J Frame class. Here's a list of names used in the 
code: 
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setTi tl e: Calling setTi tl e puts words in the frame's title bar. 
(The new Si mple Frame object is calling its own setTi tl e method.) 

Layout: An instance of the Fl owLayout class positions objects 
e frame in centered, typewriter fashion. Because the frame in 
Figure 9-4 has only one button on it, that button is centered near the top 
of the frame. If the frame had eight buttons, five of them may be lined up 
in a row across the top of the frame, and the remaining three would be 
centered along a second row. 

setLayout: Calling setLayout puts the new Fl owLayout object in 
charge of arranging components, such as buttons, on the frame. 
(The new Si mple Frame object is calling its own setLayout method.) 

setDefaultCloseOperation: Calling setDefaultCloseOperation 
tells Java what to do when you click the little x in the frame's upper-right 
corner. Without this method call, the frame itself disappears, but the 
Java Virtual Machine (JVM) keeps running. If you use JCreator, you have 
to halt the JVM by choosing ToolsOStop Tool. 

Calling setDef aul tCl oseOperati on ( EXIT_0N_CL0SE ) tells Java 
to shut itself down when you click the x in the frame's upper-right 
corner. The alternatives to EXIT_0N_CL0SE are H I DE_0N_C LOSE, 
D I S PO S E_0 N_C LO S E, and my personal favorite, D0_N0THI NG_0N_CL0SE. 

J Button: The J Butt on class lives in the javax.swing package. One of 
the class's constructors takes a Stri ng instance (such as " Pani c") for 
its parameter. Calling this constructor makes that String instance into 
the label on the face of the new button. 

add: The new Simpl eFrame object calls its add method. Calling the add 
method places the button on the object's surface (in this case, the sur- 
face of the frame). 

setSi ze: The frame becomes 300 pixels wide and 100 pixels tall. (In the 
javax.swing package, whenever you specify two dimension numbers, 
the width number always comes before the height number.) 

setVi si bl e: When it's first created, a new frame is invisible. But when 
the new frame calls setVisible(true), the frame appears on your 
computer screen. 
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In this part . . . 

there's where I start sharing some big-time Java 
▼ W concepts. This part of the book describes the tricky 
things, the little nooks and crannies, the special rules, and 
the not-so-special exceptions. As usual, you shouldn't feel 
intimidated. I take you one step at a time and keep the 
whole thing light, interesting, and manageable. 













Chapter 10 

Variables and Methods 
Where They Belong 



In This Chapter 

Making something belong to an entire class 
Putting variables inside and outside methods 
Improving your batting average 



n ello, again. You're listening to radio station WWW, and I'm your host, 
¥ W Sam Burd. It's the start again of the big baseball season, and today 
station WWW brought you live coverage of the Hankees versus Socks game. 
At this moment, I'm awaiting news of the game's final score. 

If you remember from earlier this afternoon, the Socks looked like they were 
going to take those Hankees to the cleaners. Then, the Hankees were belting 
ball after ball, giving the Socks a run for their money. Those Socks! I'm glad 
I wasn't in their shoes. 

Anyway, as the game went on, the Socks pulled themselves up. Now the 
Socks are nose to nose with the Hankees. We'll get the final score in a minute, 
but first, a few reminders. Stay tuned after this broadcast for the big Jersey's 
game. And don't forget to tune in next week when the Cleveland Gowns play 
the Bermuda Shorts. 



Okay, here's the final score. Which team has the upper hand? Which team will 
come out a head? And the winner is . . . oh, no! It's a tie! 
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As far as I'm concerned, a baseball player has a name and a batting average. 
Listing 10-1 puts my feeling about this into Java program form. 



Listing 10-1: The Player Class 

import Java. text. Decimal Format; 

class Player { 

private String name; 
private double average; 

public PI ayer ( Stri ng name, double average) { 
thi s . name=name ; 
this.average=average; 

) 

public String getNameO I 
return name; 

) 

public double getAverageO { 
return average; 

) 

public String getAverageStri ng( ) { 
Deci mal Format decFormat = 

new Decimal Format( " .000") 
return decFormat. form at (average); 



So here I go, picking apart the code in Listing 10-1. Luckily, earlier chapters 
cover lots of stuff in this code. The code defines what it means to be an 
instance of the PI ayer class. Here's what's in the code: 

V Declarations of the variables name and average. For bedtime reading 
about variable declarations, see Chapter 4. 

A constructor to make new instances of the PI ayer class. For the low- 
down on constructors, see Chapter 9. 
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V Getter methods for the variables name and average. For chitchat about 
accessor methods (that is, setter and getter methods), see Chapter 7. 



ethod that returns the player's batting average in Stri ng form, 
he good word about methods, see Chapter 7. 



Another Way to beautify your numbers 

The last method in Listing 10-1 takes the value from the average variable 
(a player's batting average), converts that value (normally of type double) 
into a S t r i n g , and then sends that String value right back to the method 
caller. The use of Deci mal Format, which comes right from the Java API 
(Application Programming Interface), makes sure that the String value 
looks like a baseball player's batting average. That is, the String value starts 
with lots of blank spaces, has no digits to the left of the decimal point, and 
has exactly three digits to the right of the decimal point. (The blank spaces 
ensure that a gap exists between the batting average and whatever text 
appears before it.) 

Java's Deci mal Format class can be quite handy. For example, to display the 
values 345 and -345 with an accounting-friendly format, you can use the 
following code: 

Deci mal Format decFormat = 

new Decimal Formate "$###0 . 00 ;( $###0 . 00 )") ; 

Sy stem. out. println(decFormat.format(345)); 
System.out.println(decFormat.format(-345)); 

In this little example's format string, everything before the semicolon dictates 
the way positive numbers are displayed, and everything after the semicolon 
determines the way negative numbers are displayed. So with this format, the 
numbers 345 and -345 appear as follows: 

$345.00 
($345.00) 

To discover some other tricks with numbers, visit the Decimal Format page 
of Java's API documentation. 



Using the Player class 

Listings 10-2 and 10-3 have code that uses the PI ayer class — the class that's 
defined way back in Listing 10-1. 
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Listing 10-2: Using the Player Class 




port j ava . uti 1 . Scanner ; 
j a v a . i o . F i 1 e ; 
java.io.IOException; 
mport j avax . swi ng . J Frame ; 
mport j avax . swi ng . J Label ; 
import j ava . awt . Gri dLayout ; 

class TeamFrame extends JFrame 



public TeamFrameO throws IOException I 
Player player; 
Scanner myScanner = 

new Scanner(new Fi 1 e( "Hankees .txt" ) ) ; 

for (int num = 1; num <= 9; num++) ( 
player = 

new PI ay er( my Scanner, next LineO, 

myScanner . nextDoubl e( ) ) ; 
myScanner. nextl_ine( ) ; 



} 



addPlayerlnfo(player) ; 



setTi tl e ( "The Hankees"); 
setl_ayout(new GridLayout(9,2) ) ; 
setDefaul tCl oseOperati on ( EXIT_0I 
pack( ) ; 

setVisible(true) ; 



_CL0SE) ; 



} 



void addPl ayerlnf o( PI ayer player) { 
add ( new J Label ( pi ayer . get Name ())) ; 
add(new J Label ( pi ayer. get AverageStringO)) 

) 



Listing 10-3: Displaying a Frame 



import java.io.IOException; 
class ShowTeamFrame { 



public static void main(String args[]) 

throws IOException 

new TeamFrame( ) ; 
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For a run of the code in Listings 10-1, 10-2, and 10-3, see Figure 10-1. To run 
this program yourself, you need the Hankees . txt file. (The file is loaded 
ally onto your hard drive when you install JCreator from this 
ROM.) This file contains data on your favorite baseball players. 
(See Figure 10-2.) 



Figure 10-1: 

Would you 
bet money 
on these 
people? 



^ The Hankees 






Barry Burd 


.101 




Harriet Ritter 


.200 




Weelie J. Katz 


.030 




Harry "The Crazyman" Spoonswagler .124 




Felicia "Fishy" Katz 


.075 




Mia, Just "Mia" 


.111 




Jeremy Flooflong Jones 


.102 




I. M. D'Arthur 


.001 




Hugh Ft. DaReader 


.212 





Figure 10-2: 

What 
a team! 




Hankees.txt ShowTeamFrame.java Player .ja v. 



Barry Burd 
.101 

Harriet Ritter 
. 200 

Weelie J . Katz 
.030 

Harry "The Crazyman" Spoonswagler 
.124 

Felicia "Fishy" Katz 
.075 

Mia, Just "Mia" 
111 

Jeremy Floof long Jones 
.102 

I. M. D'Arthur 
.001 

Hugh R . DaReader 

.212 



For this section's code to work correctly, you must have a line break after the 
last .212 in Figure 10-2. For details about line breaks, see Chapter 8. 



Nine, count 'em, nine 

The code in Listing 10-2 calls the PI ayer constructor nine times. This means 
that the code creates nine instances of the PI ayer class. Each instance has 
its own name and average variables. Each instance also has its own PI ayer 
constructor and its own getName, getAverage, and getAverageStri ng 
methods. Look at Figure 10-3 and think of the PI ayer class with its nine 
incarnations. 
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Figure 10-3: 

A class and 
its objects. 




.mstancej) (^jnstance^) (Jnstance^) CJnstance^) Cjnstance^) ( s jnstancej> Qjnstance^) Cjnstance^) C^instan 

Barry Harriet Weelie Harry Fishy Mia Jeremy I. M. Hugh 

.101 .200 .030 .124 .075 .111 .102 .001 .212 

constructor constructor constructor constructor constructor constructor constructor constructor constructor 

getName getName getName getName getName getName getName getName getName 

getAv getAv getAv getAv getAv getAv getAv getAv getAv 

getAvStr getAvStr getAvStr getAvStr getAvStr getAvStr getAvStr getAvStr getAvStr 



Don't yet ali GUI on me 

The code in Listing 10-2 uses several names from the Java API. Some of these 
names are explained in Chapter 9. Others are explained right here: 

J La be 1 : A J La be 1 is an object with some text in it. One of the ways to 
display text inside the frame is to add an instance of the J Label class to 
the frame. 

In Listing 10-2, the addPl ayerlnf o method is called nine times, once 
for each player on the team. Each time addPl ayerlnf o is called, the 
method adds two new J Label objects to the frame. The text for each 
J Label object comes from a player object's getter method. 

Gri dLayout: A Gri dLayout arranges things in evenly spaced rows 
and columns. This constructor for the Gri dLayout class takes two 
parameters — the number of rows and the number of columns. 

In Listing 10-2, the call to the Gri dLayout constructor takes parameters 
( 9 , 2 ) . So in Figure 10-1, the display has nine rows (one for each player) 
and two columns (one for a name, and another for an average). 

i>* pack: When you pack a frame, you set the frame's size. That's the size 
the frame has when it appears on your computer screen. Packing a 
frame shrink-wraps the frame around whatever objects you've added 
inside the frame. 

In Listing 10-2, by the time you've reached the call to pack, you've 
already called addPlayerlnfonine times and added 1 8 labels to the 
frame. In executing the pack method, the computer picks a nice size for 
each label, given whatever text you've put inside the label. Then, the 
computer picks a nice size for the whole frame, given that the frame has 
these 18 labels inside it. 

When you plop stuff onto frames, you have quite a bit of leeway with the 
order in which you do things. For instance, you can set the layout before or 
after you've added labels and other stuff to the frame. If you call setLayout 
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and then add labels, the labels appear in nice, orderly positions on the frame. 
If you reverse this order (add labels and then call setLayout), the calling of 
ut rearranges the labels in a nice, orderly fashion. It works fine 



In setting up a frame, the one thing that you shouldn't do is violate the follow- 
ing sequence: 



Add things to the frame, then 
pack( ) ; 

setVisible(true) ; 



If you call pack and then add more things to the frame, the pack method 
doesn't take the more recent things that you've added into consideration. If 
you call setVi si bl e before you add things or call pack, the user sees the 
frame as it's being constructed. Finally, if you forget to set the frame's size 
(by calling pack or some other sizing method), the frame that you see looks 
like the one in Figure 10-4. (Normally, I wouldn't show you an anomalous run 
like the one in Figure 10-4, but I've made the mistake so many times that I feel 
as if this puny frame is an old friend of mine.) 



Figure 10-4: 

An under- 
nourished 
frame. 



Tossing an exception from 
method to method 

Chapter 8 introduces input from a disk file, and along with that topic comes 
the notion of an exception. When you tinker with a disk file, you need to 
acknowledge the possibility of raising an IOExcepti on. That's the lesson 
from Chapter 8, and that's why the constructor in Listing 10-2 has a th rows 
IOExcepti on clause. 



But what about the main method in Listing 10-3? With no apparent reference 
to disk files in this mai n method, why does the method need its own throws 
IOExcepti on clause? Well, an exception is a hot potato. If you have one, you 
have to either eat it (as you can see in Chapter 12) or use a throws clause to 
toss it to someone else. If you toss an exception with a throws clause, some- 
one else is stuck with the exception just the way you were. 
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The constructor in Listing 10-2 throws an IOException, but to whom is this 
exception thrown? Who in this chain of code becomes the bearer of responsi- 
ble problematic IOException? Well, who called the constructor in 
2? It was the main method in Listing 10-3 — that's who called the 
me constructor. Because the TeamFrame constructor throws its hot 
potato to the main method in Listing 10-3, the ma i n method has to deal with 
it. As shown in Listing 10-3, the main method deals with it by tossing the 
IOExcepti on again (by having a throws IOExcepti on clause of its own). 
That's how the throws clause works in Java programs. 

If a method calls another method, and the called method has a throws 
clause, the calling method must contain code that deals with the exception. 
To find out more about dealing with exceptions, read Chapter 12. 

At this point in the book, the astute For Dummies reader may pose a follow- 
up question or two. "When amain method has a throws clause, someone 
else has to deal with the exception in that throws clause. But who called the 
mai n method? Who deals with the IOExcepti on in the throws clause of 
Listing 10-3?" The answer is that the Java Virtual Machine (or JVM, the thing 
that runs all your Java code) called the main method. So the JVM takes care 
of the IOExcepti on in Listing 10-3. If the program has any trouble reading 
the Han kees . txt file, the responsibility ultimately falls on the JVM. The JVM 
takes care of things by displaying an error message and then ending the run 
of your program. How convenient! 



Making Static (Finding 
the Team Average) 

Thinking about the code in Listings 10-1 through 10-3, you decide that you'd 
like to find the team's overall batting average. Not a bad idea! The Hankees in 
Figure 10-1 have an average of about .106, so the team needs some intensive 
training. While the players are out practicing on the ball field, you have a 
philosophical hurdle to overcome. 



In Listings 10-1 through 10-3, you have three classes: a PI aye r class and two 
other classes that help display data from the PI aye r class. So in this class 
morass, where do the variables storing your overall, team-average tally go? 

It makes no sense to put tally variables in either of the displaying classes 
(TeamFrame and ShowTeamFrame). After all, the tally has something or 
other to do with players, teams, and baseball. The displaying classes are 
about creating windows, not about playing baseball. 
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You're uncomfortable putting an overall team average in an instance of 
the PI aye r class because an instance of the PI aye r class represents 
one player on the team. What business does a single player have 
ing overall team data? Sure, you could make the code work, but it 
wouldn't be an elegant solution to the problem. 



Finally you discover the keyword static. Anything that's declared to be 
static belongs to the whole class, not to any particular instance of the class. 
When you create the static variable, totalOfAverages, you create just one 
copy of the variable. This copy stays with the entire PI ayers class. No 
matter how many instances of the PI aye r class you create — one, nine, or 
none — you have just one tota 1 Of Averages variable. And, while you're at it, 
you create other stati c variables (pi ayerCount and decFormat) and 
stati c methods (f i ndTeamAverage and f i ndTeamAverageStri ng). To see 
what I mean, look at Figure 10-5. 



Figure 10-5: 

Some 
static and 
non-static 
variables 
and 
methods. 



The PlayerPlus class 



playerCount 
totalOfAverages 
decFormat 
findTeamAverage 
findTeamAverageString 




Barry 
.101 

constructor 
getName 
getAv 
getAvStr 



Harriet 
.200 

constructor 
getName 
getAv 
getAvStr 



Weelie 
.030 

constructor 
getName 
getAv 
getAvStr 



Harry 
.124 

constructor 
getName 
getAv 
getAvStr 



Fishy 
.075 

constructor 
getName 
getAv 
getAvStr 



Mia 
.111 

constructor 
getName 
getAv 
getAvStr 



Jeremy 
.102 

constructor 
getName 
getAv 
getAvStr 



I.M. 
.001 

constructor 
getName 
getAv 
getAvStr 



Hugh 
.212 

constructor 
getName 
getAv 
getAvStr 



Going along with your passion for subclasses, you put code for team-wide tal- 
lies in a subclass of the PI ayer class. The code is shown in Listing 10-4. 



Listing 10-4: Creating a Team Batting Average 



import Java. text. Decimal Format; 




class PlayerPlus extends Player { 




private static int playerCount = 0; 




private static double totalOfAverages = .000; 




private static Decimal Format decFormat = 




new Decimal Format( " 


.000"); 



(continued) 
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ublic PI ayerPl us ( Stri ng name, double average) { 
super(name, average); 
pi ayerCount++; 
total OfAverages += average; 
} 



public static double f i ndTeamAverage( ) { 
return total OfAverages / playerCount; 

) 

public static String f i ndTeamAverageStri ng( ) ( 
return decFormat . format 

(total Of Averages / playerCount) 

) 



Why is there so much static} 

Maybe you've noticed — the code in Listing 10-4 is overflowing with the word 
static. That's because nearly everything in this code belongs to the entire 
PI aye r PI us class and not to individual instances of the class. That's good 
because something like playerCount (the number of players on the team) 
shouldn't belong to individual players, and having each PI ayerPl us object 
keep track of its own count would be silly ("I know how many players I am. 
I'm just one player!") If you had nine individual pi ayerCount variables, 
either each variable would store the number 1 (which is useless) or you 
would have nine different copies of the count, which is wasteful and prone to 
error. So by making pi ayerCount static, you're keeping the pi ayerCount in 
just one place, where it belongs. 

The same kind of reasoning holds for the totalOfAverages. Eventually, the 
totalOfAverages variable will store the sum of the players' batting aver- 
ages. For all nine members of the Hankees, this adds up to .956. It's not until 
someone calls the f i ndTeamAverage or fi ndTeamAverageStri ng method 
that the computer actually finds the overall Hankee team batting average. 

You also want the methods fi ndTeamAverage and fi ndTeamAverageStri ng 
to be static. Without the word static, there would be nine f i ndTeamAverage 
methods — one for each instance of the PI ayerPl us class. This wouldn't 
make much sense. Each instance would have the code to calculate 
total OfAverages/pl ayerCount on its own, and each of the nine calcula- 
tions would yield the very same answer. 




In general, any task that all the instances have in common (and that yields 
the same result for each instance) should be coded as a stati c method. 
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10-4, the decFormat variable is static. This makes sense, because 
kfcVasStet makes total Of Averages / pi ayerCount look nice, and both 
variables in the expression total Of Averages / pi ayerCount are static. 
Thinking more directly, the code needs only one thing for formatting num- 
bers. If you have several numbers to format, the same decFormat thing that 
belongs to the entire class can format each number. Creating a decFormat for 
each player is not only inelegant, but also wasteful. 

^pJ-Sr^ In this book, my first serious use of the word static is way back in Listing 3-1. 
I use the static keyword as part of every main method (and lots of m a i n 
methods are in this book's listings). So why does main have to be static? 
Well, remember that non-static things belong to objects, not classes. If the 
ma i n method isn't static, you can't have amain method until you create an 
object. But, when you start up a Java program, no objects have been created 
yet. The statements that are executed in the main method start creating 
objects. So, if the ma i n method isn't static, you have a big chicken-and-egg 
problem. 




Displaying the overall team average 

You may be noticing a pattern. When you create code for a class, you gener- 
ally write two pieces of code. One piece of code defines the class, and the 
other piece of code uses the class. (The ways to use a class include calling 
the class's constructor, referencing the class's nonprivate variables, calling 
the class's methods, and so on.) Listing 10-4, shown previously, contains 
code that defines the PI ayerPl us class, and Listing 10-5 contains code that 
uses this PI ayerPl us class. 



Listing 10-5: Using the Code from Listing 10-4 

import j ava . uti 1 . Scanner ; 
import j ava . i o . Fi 1 e ; 
import j ava . i o . IOExcepti on ; 
import j avax . swi ng . J Frame ; 
import j avax . swi ng . J Label ; 
import j ava . awt . Gri dLayout ; 

class TeamFrame extends JFrame { 

public TeamFrameO throws IOException I 
PlayerPlus player; 
Scanner myScanner = 

new Scanner(new Fi 1 e( "Hankees . txt " ) ) ; 



(continued) 
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for (int num = 1; num <= 9; num++) I 
player = 

new PI aye r PI us (my Scanner, next LineO, 

my Scanner, next DoubleO); 
myScanner.nextl_ine( ) ; 



} 



add PI aye r Info (pi ayer) ; 



')) 



add(new JLabel ( ) ) ; 
add(new JLabel ( " — 
add(new JLabel ("Team Batting Average:")); 
add (new JLabel ( PI ayer PI us .fi ndTeamAverageStri ng( ) ) ) 



setTi tl e ( "The Hankees"); 
set Layout ( new Gri d Lay out ( 11 , 2 ) ) ; 
setDefaultCl oseOperati on ( EXIT_0N_CL0SE ) ; 
pack( ) ; 

setVisible(true) ; 



} 



void addPl ayerlnf o( PI ayerPl us player) { 
add ( new J Label ( pi ayer . get Name ( ) ) ) ; 
add ( new J Label ( pi ayer . get Aver ageStri ng( ) ) ) ; 



To run the code in Listing 10-5, you need a class with amain method. The 
ShowTeamFrame class in Listing 10-3 works just fine. (If you run JCreator from 
this book's CD-ROM, you're all set because the ShowTeamFrame .Java file is 
already in a project along with Listing 10-5.) 



Figure 10-6 shows a run of the code from Listing 10-5. This run depends 
on the availability of the Hankees . txt file from Figure 10-2. The code in 
Listing 10-5 is almost an exact copy of the code from Listing 10-2. (So close 
is the copy that if I could afford it, I'd sue myself for theft of intellectual prop- 
erty.) The only thing new in Listing 10-5 is the stuff shown in bold. 



Figure 10-6: 

A run of 
the code in 
Listing 10-5. 



JpThe Hankees 




ESQ 


Barry Burd 


.101 




Harriet Ritter 


.200 




Weelie J. Katz 


.030 




Harry "The Crazyman" Spoonswagler .124 




Felicia "Fishy" Katz 


.075 




Mia, Just "Mia" 


.111 




Jeremy Flooflong Jones 


.102 




1. M. D'Arthur 


.001 




Hugh R. DaReader 


.212 




Team Batting Average: 


.106 
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In Listing 10-5, the Grid Layout has two extra rows: one row for spacing and 
another row for the Hankee team's average. Each of these rows has two 
jects in it. 

spacing row has a blank label and a label with a dashed line. The 

blank label is a placeholder. When you add components toaGridLayout, 
the components are added row by row, starting at the left end of a row 
and working toward the right end of the row. Without this blank label, 
the dashed line label would appear at the left end of the row, under 
Hugh R. DaReader's name. 

v 0 The other row has a label displaying the words Team Batting 

Average, and another label displaying the number .1 06. The method 
call that gets the number .106 is interesting. The call looks like this: 

PI ayerPl us . f i ndTeamAverageStri ng( ) 

Take a look at that method call. That call has the following form: 

CI assName .methodNamei ) 

That's new and different. In earlier chapters, I say that you normally 
preface a method call with an object's name, not a class's name. So why 
do I use a class name here? The answer: When you call astatic method, 
you preface the method's name with the name of the class that contains 
the method. The same holds true whenever you reference another 
class's static variable. This makes sense. Remember, the whole class 
that defines astatic variable or method owns that variable or method. 
So, to refer to a stati c variable or method, you preface the variable or 
method's name with the class's name. 




When you're referring to a stati c variable or method, you can cheat and use 
an object's name in place of the class name. For instance, in Listing 10-5, with 
judicious rearranging of some other statements, you can use the expression 

player.findTeamAverageStringO. 

Java has a neat feature called the static initializer. Using this feature, you can 
execute statements involving static variables before calling any of the 
class's methods. To find out more about stati c initializers, visit this book's 
Web site. 



Static is old hat 

This section makes a big noise about static variables and methods, but 
static things have been part of the picture since early in this book. For 
example, Chapter 3 introduces System . out . pri ntl n. The name System 
refers to a class, and out is a stati c variable in that class. That's why, in 
Chapter 4 and beyond, I use the static keyword to import the out variable: 
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tati c variables and methods show up all over the place. When 
clared in someone else's code, and you're making use of them in 
your code, you hardly ever have to worry about them. But when you're 
declaring your own variables and methods and must decide whether to make 
them static, you have to think a little harder. 



Could cause static; handle With care 

When I first started writing Java, I had recurring dreams about getting a cer- 
tain error message. The message was non-st at i c variable or method 
cannot be referenced from a static context. So often did I see this 
message, so thoroughly was I perplexed, that the memory of this message 
became burned into my subconscious existence. 

These days, I know why I get the error message so often. I can even make the 
message occur if I want. But I still feel a little shiver whenever I see this mes- 
sage on my screen. 

Before you can understand why the message occurs and how to fix the prob- 
lem, you need to get some terminology under your belt. If a variable or 
method isn't static, it's called non-static. (Real surprising, hey?) Given that 
terminology, there are at least two ways to make the dreaded message 
appear: 

It* Put CI ass .nonstati cThi ng somewhere in your program. 
i>* Put nonstati cThi ng somewhere inside a s t a t i c method. 

In either case, you're getting yourself into trouble. You're taking something 
that belongs to an object (the non-static thing) and putting it in a place where 
no objects are in sight. 

Take, for instance, the first of the two situations listed above. To see this 
calamity in action, go back to Listing 10-5. Toward the end of the listing, 
change pi ayer . getName ( ) to PI ayer . getName ( ). That does the trick. What 
could PI ayer. getName possibly mean? If it meant anything, the expression 
PI ayer. getName would mean "call the getName method that belongs to the 
entire PI ayer class." But look back at Listing 10-1. The getName method isn't 
static. Each instance of the PI ayer (or PI ayerPl us) class has a getName 
method. None of the getName methods belong to the entire class. So the call 
PI ayer . getName doesn't make any sense. (Maybe the computer is pulling 
punches when it displays the inoffensive cannot be referenced . . . 
message. Perhaps a harsh nonsensical express ion message would be 
more fitting.) 
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For a taste of the second situation (in the bullet list that I give earlier in this 
section), go back to Listing 10-4. While no one's looking, quietly remove the 
ic from the declaration of the decFormat variable (near the top of 
;). This turns decFormat into a non-static variable. Suddenly, each 
player on the team has a separate decFormat variable. 



Well, things are just hunky-dory until the computer reaches the 
f i ndTeamAverageStri ng method. That stati c method has four 
decFormat . SuchAndSuch statements in it. Once again, you're forced 
to ask what a statement of this kind could possibly mean. Method 
f i ndTeamAverageStri ng belongs to no instance in particular. (The method 
is static, so the entire PI ayerPl us class has one f i ndTeamAverageStri ng 
method.) But with the way you've just butchered the code, plain old 
decFormat, without reference to a particular object, has no meaning. So 
again, you're referencing the non-static variable, decFormat, from inside a 
static method's context. Shame! 



Experiments With Variables 

One summer during my college days, I was sitting on the front porch, loafing 
around, talking with someone I'd just met. I think her name was Janine. 
"Where are you from?" I asked. "Mars," she answered. She paused to see 
whether I'd ask a follow-up question. 

As it turned out, Janine was from Mars, Pennsylvania, a small town about 
20 miles north of Pittsburgh. Okay, so what's my point? The point is that the 
meaning of a name depends on the context. If you're just north of Pittsburgh 
and ask, "How do I get to Mars from here?" you may get a sensible, noncha- 
lant answer. But if you ask the same question standing on a street corner in 
Manhattan, you'll probably arouse some suspicion. (Okay, knowing 
Manhattan, people would probably just ignore you.) 

Of course, the people who live in Mars, Pennsylvania, are very much aware 
that their town has an oddball name. Fond memories of teenage years at 
Mars High School don't prevent a person from knowing about the big red 
planet. On a clear evening in August, you can still have the following conver- 
sation with one of the local residents: 

You: How do I get to Mars? 

Local resident: You're in Mars, pal. What particular part of Mars are you 
looking for? 

You: No, I don't mean Mars, Pennsylvania. I mean the planet Mars. 

Local resident: Oh, the planet! Well, then, catch the 8:19 train leaving for 
Cape Canaveral . . . No, wait, that's the local train. That'd take you 
through West Virginia. . . . 
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So the meaning of a name depends on where you're using the name. Although 
most English-speaking people think of Mars as a place with a carbon dioxide 
ere, some folks in Pennsylvania think about all the shopping they 
Mars. And those folks in Pennsylvania really have two meanings 
for theliame Mars. In Java, those names may look like this: Mars and 
pi anets . Ma rs. 



Putting a Variable in its place 

Your first experiment is shown in Listings 10-6 and 10-7. The listings' code 
highlights the difference between variables that are declared inside and out- 
side methods. 

Listing 10-6: Two Meanings for Mars 

import static Java . 1 ang . System . out ; 

class Engl i shSpeaki ngWorl d { 

String mars = " red planet"; 

void visitPennsyl vania( ) { 

out . pri ntl n ( " vi si tPA is running 

String mars = " Janine's home 

out . pri ntl n (mars ) ; 
out.println(this.mars); 

} 

) 



Listing 10-7: Calling the Code of Listing 10-6 

import static Java . 1 ang . System . out ; 

class GetGoing { 

public static void main(String args[]) I 
out . pri ntl n ( "mai n is running:"); 

Engl i shSpeaki ngWorl d e = new Engl i shSpeaki ngWorl d( ) ; 

//out . pri ntl n(mars) ; cannot resolve symbol 
out . pri ntl n ( e .mars ) ; 
e.visitPennsylvaniaO; 




:"); 
town" ; 



Chapter 10: Putting Variables and Methods Where They Belong 



DropBo 



Figure 10-7 shows a run of the code in Listings 10-6 and 10-7. Figure 10-8 
shows a diagram of the code's structure. In the GetGoi ng class, the mai n 
Itbqrf^reates an instance of the EnglishSpeakingWorld class. The vari- 
fers to the new instance. The new instance is an object with a 
variable named mars inside it. That mars variable has value "red planet". 
The mars variable is called an instance variable, because the variable belongs 
to an object — an instance of the Engl i shSpeaki ngWorl d class. 



Now look at the m a i n method in Listing 1 0-7. Inside the G e t G o i n g class's 
mai n method, you aren't permitted to write out . pri ntl n (mars ). In other 
words, a bare-faced reference to any mars variable is a definite no-no. The 
mars variable that I mention in the previous paragraph belongs to the 

EnglishSpeakingWorld object, not the GetGoi ng class. 



Figure 10-7: 

A run of 
the code in 
Listings 10-6 
and 10-7. 



Coni 

main is running : 

red planet 
visitPA is running: 

Janine 1 s home town 

red planet 



EnglishSpeakingWorld 

mars (instance variable) 



red planet 



Figure 10-8: 

The 

structure of 
the code in 
Listings 10-6 
and 10-7. 



visitPennsylvania 



mars (method-local variable) 



Janine's home town 



GetGoing 



However, inside the GetGoi ng class's mai n method, you can certainly write 
e . mas because the e variable refers to your EnglishSpeakingWorld object. 
That's nice. 
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Near the bottom of the code, the visitPennsylvania method is called. 
When you're inside v i s i t Pennsy 1 van i a, you have another declaration of a 
^able, whose value is "Jan i ne ' s home town". This particular mars 
s called a method-local variable because it belongs to just one 
method' — the visitPennsylvania method. 



So now you have two variables, both with the name mars. One mars variable, 
an instance variable, has the value "red planet". The other mars variable, a 
method-local variable, has the value "Janine's home town ". In the code, 
when you use the word mars, which of the two variables are you referring to? 

The answer is, when you're visiting Pennsylvania, the variable with value 

"Janine's home town" wins. When in Pennsylvania, think the way 

the Pennsylvanians think. When you're executing code inside the 

vi si tPennsyl vani a method, resolve any variable name conflicts by going 

with variables that are declared right inside the visitPennsylvania 

method. 




So what if you're in Pennsylvania and need to refer to that two-mooned celes- 
tial object? More precisely, how does code inside the visitPennsylvania 
method refer to the variable with value "red planet"? The answer is, use 
thi s .mars. The word this points to whatever object contains all this code 
(and not to any methods inside the code). That object, an instance of the 
Engl i shSpeaki ngWorl d class, has a big, fat mars variable, and that vari- 
able's value is " red p 1 a net " . So that's how you can force code to see out- 
side the method it's in — you use the Java keyword this. 

For more information on the keyword this, see Chapter 9. 



Telling a Variable Where to qo 

Years ago, when I lived in Milwaukee, Wisconsin, I made frequent use of the 
local bank's automatic teller machines. Machines of this kind were just begin- 
ning to become standardized. The local teller machine system was named 
TYME, which stood for Take Your Money Everywhere. 

I remember traveling by car out to California. At one point, I got hungry and 
stopped for a meal, but I was out of cash. So I asked a gas station attendant, 
"Do you know where there's a TYME machine around here?" 

So you see, a name that works well in one place could work terribly, or not at 
all, in another place. In Listings 10-8 and 10-9, 1 illustrate this point (with more 
than just an anecdote about teller machines). 
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Listing 1 0-8: Tale of Atomic City 

ilnport static Java . 1 ang . System . out ; 



String mars; 

void vi si tldahoC ) { 

out . pri ntl n ( " vi si tID is running:"); 

mars = " red planet"; 

String atomicCity = " Population: 25"; 

out . pri ntl n (mars ) ; 

out . pri ntl n ( atomi cCi ty ) ; 

} 

void visitNewJersey( ) { 

out . pri ntl n ( " vi si tNJ is running:"); 

out . pri ntl n (mars ) ; 

//out . pri ntl n ( atomi cCi ty ) ; 

// cannot resolve symbol 



Listing 10-9: Calling the Code of Listing 10-8 

class GetGoing2 ( 

public static void main(String args[]) { 

Engl i shSpeaki ngWorl d2 e = new Engl i shSpeaki ngWorl d2 () ; 



Figure 10-9 shows a run of the code in Listings 10-8 and 10-9. Figure 10-10 shows 
a diagram of the code's structure. The code for EnglishSpeakingWorld2 
has two variables. The ma rs variable, which isn't declared inside a method, is 
an instance variable. The other variable, atomi cCi ty, is a method-local vari- 
able and is declared inside the v i s i 1 1 d a h o method. 




Engl i shSpeaki ngWorl d2 I 



e . v i s i 1 1 d a h o ( ) ; 

e . vi si tNewJersey ( ) ; 
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red planet 



Figure 10-10: 

The struc- 
ture of the 
code in 
Listings 10-8 
and 10-9. 



EnglishSpeakingWorld2 



mars (instance variable) 



red planet 



visitldaho 



atomicCity 

(method-local variable) 



Population: 25 



visitNewJersey 







In Listing 10-8, notice where each variable can and can't be used. When you 
try to use the atomi cCi ty variable inside the vi si tNew Jersey method, you 
get an error message. Literally, the message says cannot resol ve symbol . 
Figuratively, the message says, "Hey, buddy, Atomic City is in Idaho, not 
New Jersey." Technically, the message says that the method-local variable 
atomi cCi ty is available only in the visitldaho method because that's 
where the variable was declared. 

So back inside the visitldaho method, you're free to use the atomi cCi ty 
variable as much as you want. After all, the atomi cCi ty variable is declared 
inside the visitldaho method. 

And what about Mars? Have you forgotten about your old friend, that lovely 
eighty-degrees-below-zero planet? Well, both the visitldaho and 
vi si tNewJersey methods can access the mars variable. That's because the 
ma rs variable is an instance variable. The mars variable is declared in the 
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code for the EnglishSpeakingWorld2 class but not inside any particular 
method. (In my stories about the names for things, remember that people 

in both states, Idaho and New Jersey, have heard of the planet Mars.) 



The lifecycle of the mars variable has three separate steps: 

When the EnglishSpeakingWorld2 class first flashes into existence, 
the computer sees String mars and creates space for the variable. 

When the v i s i 1 1 d a h o method is executed, the method assigns the 
value "red pi a net" to the ma rs variable. (The vi si t Ida ho method 
also prints the value of the mars variable.) 

V When the vi si t New Jersey method is executed, the method prints the 
mars value once again. 

In this way, the mars variable's value is passed from one method to another. 



Passing Parameters 

A method can communicate with another part of your Java program in sev- 
eral ways. One of the ways is through the method's parameter list. Using a 
parameter list, you pass on-the-fly information to a method as the method is 
being called. 

So imagine that the information you pass to the method is stored in one of 
your program's variables. What, if anything, does the method actually do 
with that variable? This section presents a few interesting case studies. 



Pass by Value 

According to my Web research, the town of Smackover, Arkansas, has 2,232 
people in it. But my research isn't current. Just yesterday, Dora Kermongoos 
celebrated a joyous occasion over at Smackover General Hospital — the birth 
of her healthy, blue-eyed baby girl. (The girl weighs 7 pounds, 4 ounces, and 
is 21 inches tall.) Now the town's population has risen to 2,233. 

Listing 10-10 has a very bad program in it. The program is supposed to add 1 
to a variable that stores Smackover's population, but the program doesn't 
work. Take a look at Listing 10-10 and see why. 
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pass TrackPopul ati on { 



lie static void mairHString args[]) 
int smackoverARpop = 2232; 



bi rth(smackoverARpop) ; 

System . out . pri ntl n ( smackoverARpop ) 

) 

static void birth (int city Pop) { 

cityPop++; 



When you run the program in Listing 10-10, the program displays the number 
2,232 on-screen. After nine months of planning and anticipation and a whop- 
ping seven hours in labor, the Kermongoos family's baby girl wasn't regis- 
tered in the system. What a shame! 

The improper use of parameter passing caused the problem. In Java, when 
you pass a parameter that has one of the eight primitive types to a method, 
-jERf/i/ that parameter is passed by value. 

° ■ R »>* For a review of Java's eight primitive types, see Chapter 4. 

Here's what this means in plain English: Any changes that the method makes 
to the value of its parameter don't affect the values of variables back in the 
calling code. In Listing 10-10, the bi rth method can apply the ++ operator to 
ci ty Pop all it wants — the application of ++ to the ci tyPop parameter has 
absolutely no effect on the value of the smackoverARpop variable back in the 
mai n method. 



Technically, what's happening is the copying of a value. (See Figure 10-11.) 
When the mai n method calls the bi rth method, the value stored in 
smackoverARpop is copied to another memory location — a location 
reserved for the ci tyPop parameter's value. During the bi rth method's 
execution, 1 is added to the ci ty Pop parameter. But the place where the orig- 
inal 2232 value was stored — the memory location forthesmackoverARpop 
variable — remains unaffected. 




When you do parameter passing with any of the eight primitive types, the 
computer uses pass by value. The value stored in the calling code's variable 
remains unchanged. This happens even if the calling code's variable and the 
called method's parameter happen to have the exact same name. 
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Figure 10-11: 

Pass by 
value, under 
the hood. 




Returning a result 

You must fix the problem that the code in Listing 10-10 poses. After all, a 
young baby Kermongoos can't go through life untracked. To record this 
baby's existence, you have to add 1 to the value of the smackoverARpop vari- 
able. You can do this in plenty of ways, and the way presented in Listing 10-11 
isn't the simplest. Even so, the way shown in Listing 10-11 illustrates a point: 
Returning a value from a method call can be an acceptable alternative to 
parameter passing. Look at Listing 10-1 1 to see what I mean. 



Listing 10-11: This Program Works 



class TrackPopul ati on2 { 

public static void main(String args[]) ( 
int smackoverARpop = 2232; 

smackoverARpop = bi rth(smackoverARpop) ; 

System.out.println(smackoverARpop); 

) 

static int birth (int city Pop) I 
return ci tyPop + 1 ; 

) 

) 



After running the code in Listing 10-11, the number you see on your com- 
puter screen is the correct number, 2,233. 
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The code in Listing 10-1 1 has no new features in it (unless you call working 
correctly a new feature). The most important idea in Listing 10-11 is the 

tatement, which also appears in Chapter 7. Even so, Listing 10-11 
a nice contrast to the approach in Listing 10-10, which had to be 
discarded. 



Pass by reference 

In the previous section or two, I take great pains to emphasize a certain 
point — that when a parameter has one of the eight primitive types, the para- 
meter is passed by value. If you read this, you probably missed the emphasis 
on the parameter's having one of the eight primitive types. The emphasis is 
needed because passing objects (reference types) doesn't quite work the 
same way. 

When you pass an object to a method, the object is passed by reference. What 
this means to you is that statements in the called method can change any 
values that are stored in the object's variables. Those changes do affect the 
values that are seen by whatever code called the method. Listings 10-12 
and 10-13 illustrate the point. 



Listing 10-12: What Is a City? 



class City { 

int population; 

) 



Listing 10-13: Passing an Object to a Method 

class TrackPopul ati on3 { 

public static void main(String args[]) { 
City smackoverAR = new CityO; 
smackoverAR. popul ati on = 2232; 
bi rth(smackoverAR) ; 

Sy st em. out. pn'ntln(smackoverAR. population); 



static void birth(City aCity) { 
aCi ty . popul ati on++; 
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When you run the code in Listings 10-12 and 10-13, the output that you get is 
the number 2,233. That's good because the code has things like ++ and the 
72 in it. The deal is, adding 1 to aCi ty . popul ati on inside the bi rth 
dually changes the value of smackoverAR. popul ati on as it's 
knownTn the ma i n method. 



To see how the bi rth method changes the value of smackoverAR. popul ati on, 
look at Figure 10-12. When you pass an object to a method, the computer 
doesn't make a copy of the entire object. Instead, the computer makes a copy 
of a reference to that object. (Think of it the way it's shown in Figure 10-12. 
The computer makes a copy of an arrow that points to the object.) 



Figure 10-12: 

Pass by 
reference, 
underthe 
hood. 
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In Figure 10-12, you see just one instance of the Ci ty class, with a population 
variable inside it. Now keep your eye on that object as you read the following 
steps: 



1. Just before the bi rth method is called, the smackoverAR variable refers 
to that object — the instance of the C i ty class. 

2. When the bi rth method is called, and smackoverAR is passed to the 
birth method's aCi ty parameter, the computer copies the reference 
from smackoverAR to aCi ty. Now a Ci ty refers to that same object — 
the instance of the Ci ty class. 

3. When the statement aCi ty . popul ati on++ is executed inside the bi rth 
method, the computer adds 1 to the object's population variable. Now 
the program's one and only Ci ty instance has 2233 stored in its popula- 
tion variable. 

4. The flow of execution goes back to the ma i n method. The value of 
smackoverAR .popul ati on is printed. But smackoverAR refers to that 
one instance of the City class. So smackoverAR. popul ati on has the 
value 2233. The Kermongoos family is so proud. 
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or not, there's one nook and cranny of Java methods that the previ- 
ons on parameter passing didn't explore. When you call a method, 
the method can return something right back to the calling code. In previous 
chapters and sections, I return primitive values, such as i nt values, or noth- 
ing (otherwise known as void). In this section, I return a whole object. It's an 
object of type Ci ty from Listing 10-12. The code that makes this happen is in 
Listing 10-14. 



Listing 10-14: Here, Have a City 

class TrackPopul ati on4 { 

public static void main(String args[]) { 
City smackoverAR = new CityO; 
smackoverAR. popul ati on = 2232; 
smackoverAR = doBi rth(smackoverAR) ; 
Sy st em. out. println(smackoverAR. population); 

) 

static City doBi rth(City aCity) { 
City myCity = new CityO; 
myCi ty . popul ati on = aCi ty . popul ati on + 1; 
return myCity; 

) 

) 

If you run the code in Listing 10-14, you get the number 2,233. That's good. 
The code works by telling the doBi rth method to create another Ci ty 
instance. In the new instance, the value of popul ati on is 2333 (Figure 10-13). 
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Figure 10-13: 

ThedoBirth 
method 
creates 
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When the doBi rth method is finished being executed, that Ci ty instance is 
returned to the main method. Then, back in the main method, that instance 
that doBi rth returns) is assigned to the smackoverAR variable, 
re 10-14.) Now smackoverAR refers to a brand-new Ci ty instance — 
an instance whose population is 2,233. 




In Listing 10-14, notice that the type consistency in the calling and returning 
of the doBi rth method: 

The smackoverAR variable has type Ci ty. The smackoverAR variable is 
passed to the aCi ty parameter, which is also of type Ci ty. 

The myCi ty variable is of type Ci ty. The myCi ty variable is sent 
back in the doBi rth method's return statement. That's consistent, 
because the doBi rth method's header begins with the promise 
public static City — the promise to return an object of type Ci ty. 

The doBi rth method returns an object of type Ci ty. Back in the main 
method, the object that the call to doBi rth returns is assigned to the 
smackoverAR variable, and (you guessed it) the smackoverAR variable 
is of type Ci ty. 

Aside from being very harmonious, all this type agreement is absolutely nec- 
essary. If you write a program, and your types don't agree with one another 
in the program, the compiler spits out an unsympathetic i ncompati bl e 
types message. 



Epilogue 

Dora Kermongoos and her newborn baby daughter are safe, healthy, and 
resting happily in their Smackover, Arkansas, home. 



Part IV: Savvy Java Techniques 



DropBooks 



Chapter 11 

DropBcjgks ^ rra y S an( | Q 0 || ec tj ons 

to Juggle Values 



In This Chapter 

Dealing with several values at once 
Creating values as you get a program running 
Impressing other programmers with fancy generic types 



m My elcome to the Java Motel! No haughty bellhops, no overpriced room 
WW service, none of the usual silly puns. Just a clean double room at a 
darn good value. 



Getting \lour bucks Alt in a Rou) 

The Java Motel, with its ten comfortable rooms, sits in a quiet place off the 
main highway. Aside from a small, separate office, the motel is just one long 
row of ground floor rooms. Each room is easily accessible from the spacious 
front parking lot. 

Oddly enough, the motel's rooms are numbered 0 through 9. 1 could say that 
the numbering is a fluke — something to do with the builder's original design 
plan. But the truth is that starting with 0 makes the examples in this chapter 
easier to write. 

Anyway, you're trying to keep track of the number of guests in each room. 
Because you have ten rooms, you may think about declaring ten variables: 

int guestsInRoomNumO , guestsInRoomNuml , guestsInRoomNum2 , 

guestsInRoomNum3 , guestsInRoomNum4, guestsInRoomNum5 , 

guestsInRoomNum6 , guestsInRoomNum7 , guestsInRoomNum8, 
guestsInRoomNum9 ; 
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Doing it this way may seem a bit inefficient. But inefficiency isn't the only 
thing wrong with this code. Even more problematic is the fact that you can't 
ugh these variables. To read a value for each variable, you have to 
nextl nt method ten times. 



guestsInRoomNumO 
guestsInRoomNuml 
guestsInRoomNum2 
. . . and so on . 



diskScanner. next Int() 
diskScanner. next Int() 
diskScanner. next Into 



Surely a better way exists. 

That better way involves an array. An array is a row of values, like the row of 
rooms in a one-floor motel. To picture the array, just picture the Java Motel: 

First, picture the rooms, lined up next to one another. 

V Next, picture the same rooms with their front walls missing. Inside each 
room you can see a certain number of guests. 

«" If you can, forget that the two guests in Room 9 are putting piles of bills 
into a big briefcase. Ignore the fact that the guests in Room 6 haven't 
moved away from the TV set in a day and a half. Instead of all these 
details, just see numbers. In each room, see a number representing the 
count of guests in that room. (If freeform visualization isn't your strong 
point, look at Figure 11-1.) 



Figure 11-1: 

An abstract 
snapshot of 
rooms in the 
Java Motel. 



A component 
whose index is 6, 
and whose value is 4 



/The value 4 
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The index 6 



In the lingo of this chapter, the entire row of rooms is called an array. Each 
room in the array is called a component of the array (also known as an array 
element). Each component has two numbers associated with it: 
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v 0 The room number (a number from 0 to 9), which is called an index of the 
array 

mber of guests, which is a value stored in a component of the array 



Using an array saves you from all the repetitive nonsense in the sample code 
shown at the beginning of this section. For instance, to declare an array with 
ten values in it, you can write one fairly short statement: 



int guests[] = new i n t [ 1 0 ] ; 



If you're especially verbose, you can expand this statement so that it 
becomes two separate statements: 

i nt guests [ ] ; 

guests = new i nt [10] ; 



In either of these code snippets, notice the use of the number 10. This 
number tells the computer to make the guests array have ten components. 
Each component of the array has a name of its own. The starting component 
is named guestsfO], the next is named guestsf 1 ], and so on. The last of the ten 
components is named guests [9]. 

In creating an array, you always specify the number of components. The 
array's indices start with 0 and end with the number that's one less than the 
total number of components. 

The snippets that I show you give you two ways to create an array. The 
first way uses one line. The second way uses two lines. If you take the single 
line route, you can put that line inside or outside a method. The choice is 
yours. On the other hand, if you use two separate lines, the second line, 
guests = new i nt [10], should be inside a method. 

In an array declaration, you can put the square brackets before or after the 
variable name. In other words, you can write int guests[] or int[] guests. The 

computer creates the same guests variable no matter which form you use. 



Creating an array in Wo easy steps 

Look once again at the two lines that you can use to create an array: 

i nt guests [ ] ; 

guests = new int[10] ; 
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guests [ ]: This first line is a declaration. The declaration reserves 
rray name (a name like guests) for use in the rest of the program. In 
the Java Motel metaphor, this line says, "I plan to build a motel here and 
put a certain number of guests in each room." (See Figure 11-2.) 

Never mind what the declaration i nt guests [ ] does. It's more impor- 
tant to notice what the declaration int guests[] doesn't do. The decla- 
ration doesn't reserve ten memory locations. Indeed, a declaration like 
int guests[] doesn't really create an array. All the declaration does is 
set up the guests variable. At that point in the code, the guests vari- 
able still doesn't refer to a real array. (In other words, the motel hasn't 
been built yet.) 

guests = new i nt[ 10]: This second line is an assignment statement. 
The assignment statement reserves space in the computer's memory for 
ten i nt values. In terms of real estate, this line says, "I've finally built the 
motel. Go ahead and put guests in each room." (Again, see Figure 11-2.) 



Figure 11-2: 

Two steps 
in creating 
an array. 



int guestsQ; 



guests 

O 



guests = new int[10]; 



guests 



/ / / / / / / / / / 



Storing Values 

After you've created an array, you can put values into the array's compo- 
nents. For instance, you would like to store the fact that Room 6 contains 
4 guests. To put the value 4 in the component with index 6, you write 
guests[6] = 4. 

Now business starts to pick up. A big bus pulls up to the motel. On the side of 
the bus is a sign that says "Noah's Ark." Out of the bus come 25 couples, each 
walking, stomping, flying, hopping, or slithering to the motel's small office. 
Only 10 of the couples can stay at the Java Motel, but that's okay because 
you can send the other 15 couples down the road to the old C-Side Resort 
and Motor Lodge. 
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Anyway, to register 10 couples into the Java Motel, you put a couple (2 guests) 
in each of your 10 rooms. Having created an array, you can take advantage of 
's indexing and write a for loop, like this: 



nt roomNum = 0; roomNum < 10; roomNum++) { 
guests[roomNum] = 2; 



This loop takes the place of ten assignment statements. Notice how the 
loop's counter goes from 0 to 9. Compare this with Figure 1 1-2, and remember 
that the indices of an array go from 0 to one less than the number of compo- 
nents in the array. 

Now, given the way the world works, your guests won't always arrive in neat 
pairs, and you'll have to fill each room with a different number of guests. You 
probably store information about rooms and guests in a database. If you do, 



you can still loop through an array, gathering numbers of guests as you go. 
The code to perform such a task may look like this: 


resultset = 

statement . executeQuery( "select ( 
for (int roomNum = 0; roomNum < 10; 


QUESTS from RoomC 
roomNum++) { 


ata" ) ; 



resul tset . next( ) ; 
guests[roomNum] = resul tset . getlntC "GUESTS" ) ; 

} 



But because this book doesn't cover databases until Chapter 18 (on the 
CD-ROM), you may be better off reading numbers of guests from a plain text 
file. A sample file is shown in Figure 1 1-3. After you've made a file, you can 
call on the Scanner class to get values from the file. The code is shown in 
Listing 11-1, and the resulting output is in Figure 11-4. 




For instructions on creating your own file like the one in Figure 11-3, 
see Chapter 8. 



Figure 11-3: 

The 
GuestList 
.txtfile. 



GuestList.txt 






1420214302 
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i|np_p_rt static ja va . 1 ang . System . out ; 
Java. uti 1 . Scanner ; 
j a v a . i o . F i 1 e ; 
import j ava . i o . IOExcepti on ; 

class ShowGuests { 

public static void main(String args[]) 

throws IOException I 

int guests[] = new int[10]; 

Scanner diskScanner = 

new Scanner(new FileCGuestList.txt")); 



for (int roomNum = 0; 
guests[roomNum] 

} 



roomNum < 10; roomNum++) { 

= di skScanner . nextlnt ( ) ; 



out.println("Room\tGuests"); 

for (int roomNum = 0; roomNum < 10; roomNum++) { 

out . pri nt ( roomNum ) ; 
out . pri nt ( " \t" ) ; 
out.println( guests [roomNum] ) ; 

} 



Figure 11-4: 

Running the 
code from 
Listing 11-1. 




The code in Listing 11-1 has two for loops. The first loop reads numbers of 
guests, and the second loop writes numbers of guests. 

Every array has a built-in length field. An array's length is the number 
of components in the array. So, in Listing 1 1-1, if you print the value of 

guests . 1 ength, you get 10. 
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Tab stops and other special things 



11-1, some calls to pri nt and pri ntl n use the \t escape sequence, 
an escape sequence because you escape from displaying the letter t 
on the screen. Instead, the characters \t stand for a tab. The computer 
moves forward to the next tab stop before printing any more characters. 
Java has a few of these handy escape sequences. Some of them are shown in 
Table 11-1. 



Table 1 1 -1 Escape Sequences 

Sequence Meaning 



\b backspace 



\t horizontal tab 






\n linefeed 






\f formfeed 






\r carriage return 






\" double quote " 






V single quote ' 







\\ backslash \ 



Using an array initializer 

Besides what you see in Listing 11-1, there's another way to fill an array in 
Java. It's with an array initializer. When you use an array initializer, you don't 
even have to tell the computer how many components the array has. The 
computer figures this out for you. 

Listing 11-2 shows a new version of the code to fill an array. The program's 
output is the same as the output of Listing 11-1. (It's the stuff shown in 
Figure 1 1-4.) The only difference between Listings 1 1-1 and 1 1-2 is the bold 
text in Listing 11-2. That bold doodad is an array initializer. 
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ipRP-Li static ja va . 1 ang . System . out ; 
howGuests { 



public static void main(String args[]) I 

int guests[] = {1, 4, 2, 0, 2, I, A, 3, 0, 2}; 
out.println("Room\tGuests"); 

for (int roomNum = 0; roomNum < 10; roomNum++) 
out . pri nt ( roomNum ) ; 
out . pri nt ( " \t" ) ; 
out.println(guests[roomNum]); 

) 



An array initializer can contain expressions as well as literals. In plain 
English, this means that you can put all kinds of things between 
the commas in the initializer. For instance, an initializer like 

jl + 3, myScanner.nextInt( ) , 2, 0, 2, %, 4, 3, 0, 2) 
works just fine. 



Stepping through an array 
tilth the enhanced {or loop 

With the new, improved, ultra-slick Java version 5.0 comes the enhanced 
for loop — the loop that doesn't use counters or indices. 

Listing 6-5 in Chapter 6 uses enhanced for loops to step through en urn types. 
Loosely speaking, an en urn type is just a bunch of values. But think about this 
chapter's arrays. An array is a bunch of values, too. So it may come as no 
surprise that an enhanced for loop can step through an array's values. 
Listing 1 1-3 shows you how to do it. 



Listing 11-3: Kids, Don't Try This with Java 1.4! 



import static ja va . 1 ang . System . out ; 




class ShowGuests { 




public static void main(String 


args[]) { 


int guests[] = {1, 4, 2, 0. 


. 2, 1, 4, 3, 0, 2) ; 


int roomNum = 0; 
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out.println("Room\tGuests"); 
for (int numGuests : guests) { 

out . pri nt( roomNum++) ; 
out . pri nt ( " \t" ) ; 
out.println(numGuests); 

) 



Listings 11-1 and 11-3 have the same output. It's in Figure 11-4. 

If you look at the loop in Listing 1 1-3, you see the same old pattern. Just like 
the loops in Listing 6-5, this example's loop has three parts: 

for (variable-type variable-name : rangeofval ues) 

The first two parts are vari ab 1 e-type and vari abl e-name. The loop in 
Listing 11-3 defines a variable named numGuests, and numGuests has type 
int. During each loop iteration, the variable numGuests takes on a new 
value. Look at Figure 11-4 to see these values. The initial value is 1. The next 
value is 4. After that comes 2. And so on. 

Where is the loop finding all these numbers? The answer lies in the loop's 
range- of -val ues. In Listing 11-3, the loop's range-of-val ues is guests. 
So, during the initial loop iteration, the value of numGuests is guests [0] 
(which is 1). During the next iteration, the value of numGuests is guests [1 ] 
(which is 4). After that comes guests [2] (which is 2). And so on. 



Searching 

You're sitting behind the desk at the Java Motel. Look! Here comes a party of 
five. These people want a room, so you need software that checks to see 
whether a room is vacant. If one is, the software needs to modify the 
Guestl_ist.txt file (refer to Figure 11-3) by replacing the number 0 with the 
number 5. As luck would have it, the software is right on your hard drive. The 
software is shown in Listing 1 1-4. 

Listing 1 1 -4: Do You Have a Room? 

import static ja va . 1 ang . System . out ; 

import j ava . uti 1 . Scanner ; 

import j ava . i o . Fi 1 e ; 

import j ava . i o . IOExcepti on ; 

import j ava . i o . Pri ntStream ; 
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(continued) 
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blic class Fi ndVacancy { 



lie static void main(String args[]) 

throws IOException 
Scanner kbdScanner = new Scanner ( System . i n ) ; 
Scanner diskScanner = 

new Scanner(new FileCGuestList.txt")); 
int guests[] = new i n t [ 1 0 ] ; 
int roomNum; 



for (roomNum = 0; roomNum < 10; roomNum++) { 
guests[roomNum] = di skScanner . nextlnt ( ) ; 

) 

roomNum = 0; 

while (roomNum < 10 && guests [roomNum] != 0) ( 
roomNum++; 

) 

if (roomNum == 10) { 

out . pri ntl n ( "Sorry , no v cancy"); 
) else { 

out . pri nt( "How many people for room "); 
out . pri nt( roomNum ) ; 
out.printC? "); 

guests[roomNum] = kbdScanner . nextlntC ) ; 

PrintStream listOut = 

new PrintStreamCGuestList.txt"); 



for (roomNum = 0; roomNum < 10; roomNum++) 
listOut.print(guests[roomNum]); 
1 i stOut . pri nt ( " "); 



Figures 1 1-5 through 1 1-7 show the running of the code in Listing 1 1-4. Back 
in Figure 1 1-3, the motel starts with two vacant rooms — Rooms 3 and 8. 
(Remember, the rooms start with Room 0.) The first time that you run the 
code in Listing 1 1-4, the program tells you that Room 3 is vacant and puts five 
people into the room. The second time you run the code, the program finds 
the remaining vacant room (Room 8) and puts a party of ten in the room. 
(What a party!) The third time you run the code, you don't have any more 
vacant rooms. When the program discovers this, it displays the message 
Sorry, no v cancy, omitting at least one letter in the tradition of all motel 
neon signs. 
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Figure TT-5: 

Filling a 
vacancy. 



Ouestl_ist.txt 






1 4 3 0 2 




General Output 


Conf iguration 

How laany people for room 3? 5 


<l 



Figure 11-6: 

Filling the 
last vacant 
room. 



GuestList.txt 



1425214302 



General Output 



Conf iguration : 

How many people for room 8? 10 



Figure 11-7: 

Sorry, Bud. 
No rooms. 



GuestList.txt 



14252143 10 2 



General Output 



Sorry, no v cancy 



-Conf iguratioi 



Each run of Listing 11-4's code writes a brand-new GuestList.txt file. If you 
use JCreator, you can easily monitor the changes to GuestLi st . txt. Keep 
GuestList.txt showing in JCreator's Editor pane. After running the code in 
Listing 1 1-4, switch to some other window on your screen (your Web browser, 
for instance) or to some other document in JCreator's Editor pane. Then 
return to the display of GuestLi st . txt in JCreator. Upon your return, 
JCreator tells you that GuestList.txt has been modified. "Do you want to 
reload it?" asks JCreator. "Yes," you click. Then JCreator displays the updated 
version of GuestLi st . txt. 

The code in Listing 11-4 uses tricks from other chapters and sections of 
this book. The code's only brand-new feature is the use of PrintStream 
to write to a disk file. Think about any example in this book that calls 
System .out . pri nt, out . pri ntl n, or their variants. What's really going 
on when you call one of these methods? 

The thing called System . out is an object. The object is defined in the Java API. 
In fact, System . out is an instance of a class named java.io.PrintStream 
(or just Pri ntSt ream to its close friends). Now each object created from the 
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PrintStream class has methods named print and pri ntl n. Just as each 
Account object in Listing 7-3 has a di spl ay method, and just as the 
Format object in Listing 10-1 has a format method, so the 
iream object named out has pri nt and pri ntl n methods. When 
you calTSystem .out .pri ntl n, you're calling a method that belongs to a 
PrintStream instance. 



Okay, so what of it? Well, System .out always stands for some text area on 
your computer screen. If you create your own Pri ntStream object, and you 
make that object refer to a disk file, then that PrintStream object refers to 
the disk file. When you call that object's print method, you write text to a 
file on your hard drive. 



So in Listing 1 1-4, when you say 



PrintStream listOut = 

new PrintStreamCGuestList.txt"); 



listOut.print(guests[roomNum]); 
1 i stOut . pri nt( " "); 



you're telling Java to write text to a file on your hard drive — the 

GuestLi st . txt file. 




That's how you update the count of guests staying in the hotel. When you 
call 1 i stOut . pri nt for the number of guests in Room 3, you may print the 
number 5. So, between Figures 11-5 and 11-6, a number in the GuestLi st . txt 
file changes from 0 to 5. Then in Figure 11-6, you run the program a second 
time. When the program gets data from the newly written Guestl_ist.txt 
file, Room 3 is no longer vacant. So this time, the program suggests Room 8. 

Like many other methods and constructors of its kind, the PrintStream con- 
structor doesn't pussyfoot around with files. If it can't find a GuestLi st . txt 
file, the constructor creates one and prepares to write values into it. But, if a 
GuestLi st . txt file already exists, the constructor clobbers the existing file 
and prepares to write to a new, empty GuestLi st . txt file. If you don't like it 
when files are clobbered, take precautions before calling the Pri ntStream 
constructor. 




This is more an observation than a tip. Say that you want to read data 
from a file named Empl oyees . txt. To do this, you make a scanner. You 
call new Scanner ( new Fi 1 e( " Empl oyees . txt " ) ). If you accidentally call 
new Scanner( "Empl oyees .txt" ) without the new Fi 1 e part, the call 
doesn't connect to your Empl oyees . txt file. But notice how you prepare 
to write data to a file. You make a Pri ntStream instance by calling new 
PrintStream("GuestList.txt"). You don't use new File anywhere in the 
call. If you goof and accidentally include new File, the Java compiler 
becomes angry, jumps out, and bites you. 
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In Listing 11-4, the condition roomNum < 10 && guests [ roomNum] != 0 
can be really tricky. If you move things around, and write guests[roomNum] != 
)mNum < 10, you can get yourself into lots of trouble. For details, 
rook's Web site. 
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Arrays of Objects 

The Java Motel is open for business, now with improved guest registration 
software! The people who brought you this chapter's first section are always 
scratching their heads, looking for the best ways to improve their services. 
Now, with some ideas from object-oriented programming, they've started 
thinking in terms of a Room class. 

"And what," you ask, "is a Room instance?" That's easy A Room instance has 
three properties — the number of guests in the room, the room rate, and a 
smoking/nonsmoking stamp. Figure 11-8 illustrates the situation. 



Figure 11-8: 

Another 
abstract 




snapshot of J 1 1 1 1 1 1 1 1 1 

rooms in the ^— 

Java Motel. 0 1 2 3 4 5 6 7 8 9 




Listing 11-5 shows the code that describes the Room class. As promised, each 
instance of the Room class has three variables: the guests, rate, and smoking 
variables. (A fa 1 se value for the boolean variable, smoking, indicates a non- 
smoking room.) In addition, the entire Room class has astatic variable named 
currency. This currency object makes room rates look like dollar amounts. 

To find out what static means, see Chapter 10. 



Listing 11-5: So This is What a Room Looks Like! 

import static ja va . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . text . NumberFormat ; 



(continued) 
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|la_ss_Room { 

ivate int guests; 
'ivate double rate; 
private boolean smoking; 
private static NumberFormat currency = 
NumberFormat.getCurrencylnstanceO 



public void readRoom(Scanner diskScanner) { 
guests = di skScanner . nextlnt( ) ; 
rate = di skScanner . nextDoubl e () ; 
smoking = di skScanner . nextBool ean () ; 



public void writeRoomO { 
out . pri nt ( guests ) ; 
out . pri nt ( " \t" ) ; 

out.print(currency.format(rate)); 
out . pri nt ( " \t" ) ; 

out . pri ntl n ( smoki ng ? "yes" : "no"); 




Listing 11-5 has a few interesting quirks, but I'd rather not describe them until 
after you see all the code in action. That's why, at this point, I move right on 
to the code that calls the Listing 1 1-5 code. After you read about arrays of 
rooms (shown in Listing 11-6), check out my description of the Listing 11-5 
quirks. 



Using the Room class 

So now you need an array of rooms. The code to create such a thing is in 
Listing 11-6. The code reads data from the Room Li st . txt file. (Figure 11-9 
shows the contents of the Rooml_ist.txt file.) 

Figure 1 1-10 shows a run of the code in Listing 1 1-6. 



Listing 1 1 -6: Would You Like to See a Room? 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . i o . Fi 1 e ; 
import j ava . i o . IOExcepti on ; 



class ShowRooms { 
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public static void mairHString args[]) 

throws IOException I 

Room rooms []; 
rooms = new Room[10]; 

Scanner di skScanner = 

new Scanner(new File( "Rooml_ist.txt" )) ; 



for (int roomNum = 0; roomNum < 10; roomNum++) { 
roomsEroomNum] = new RoomO; 
roomsEroomNum] . readRoom(diskScanner) ; 

) 

out.println("Room\tGuests\tRate\tSmoking?"); 
for (int roomNum = 0; roomNum < 10; roomNum++) { 

out . pri nt ( roomNum ) ; 

out . pri nt ( " \t" ) ; 

rooms E roomNum] .writeRoomC ) ; 

) 

) 

} 



Figure 11-9: 

A file of 
Room data. 



RoomList.txt 






1 




60 . 00 




true 




4 




60 . 00 




true 




2 




60 . 00 




false 




0 




60 . 00 




false 




2 




80.00 




true 




1 




80.00 




false 




4 




80.00 




false 








80.00 




false 




0 




100.00 




true 




2 




100.00 




false 
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Figure 11-10: 

A run of 
the code in 
Listing 11-6. 



General Output 



-Conf igurat ion : 



Guests 


Rate 


Smoking? 


1 


$60 . 00 


yes 


4 


$60 . 00 


yes 


: 


$60 . 00 


no 


0 


$60 . 00 


no 


2 


$80 . 00 


yes 


1 


$60 . 00 


no 


4 


$80 . 00 


no 


3 


$80 . 00 


no 


0 


$100.00 


yes 


2 


$100.00 


no 



Say what you want about the code in Listing 1 1-6. As far as I'm concerned, 
only one issue in the whole listing should concern you. And what, you ask, is 
that issue? Well, to create an array of objects, you have to do three things: 
make the array variable, make the array itself, and then construct each indi- 
vidual object in the array. This is different from creating an array of i nt 
values or an array containing any other primitive type values. When you 
create an array of primitive type values, you do only the first two of these 
three things. 

To help make sense of all this, follow along in Listing 11-6 and Figure 11-11 as 
you read the following points. 



Figure 11-11: 

Steps in 
creating an 
array of 
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Room rooms [ ] ; : This declaration creates a rooms variable. This vari- 
able is destined to refer to an array (but doesn't yet refer to anything 



^^V^wns = new Room[ 10] ;: This statement reserves ten slots of storage 
in the computer's memory. The statement also makes the rooms variable 
refer to the group of storage slots. Each slot is destined to refer to an 
object (but doesn't yet refer to anything at all). 

rooms [roomNum] = new Room( );: This statement is inside a for loop. 
The statement is executed once for each of the ten room numbers. 
For example, the first time through the loop, this statement says 
rooms [0] = new Room( ). That first time around, the statement makes 
the slot rooms [0] refer to an actual object (an instance of the Room class). 

Although it's technically not considered a step in array making, you still have 
to fill each object's variables with values. For instance, the first time through 
the loop, the readRoom call says rooms[l] . readRoom( di skScanner), which 
means, "Read data from the RoomLi st . txt file into the rooms [ 1 ] object's 
variables." Each time through the loop, the program creates a new object and 
reads data into that new object's variables. 

Similar to creating arrays of primitive values, you can squeeze the steps 
together. For instance, you can do the first two steps in one fell swoop, like 
this: 

Room rooms[] = new Room[10]; 

You can also use an array initializer. (For an introduction to array initializers, 
see the section, "Using an array initializer," earlier in this chapter.) 



\let another u/ay to beautify your numbers 



You can make numbers look nice in plenty of ways. For instance, Listing 7-7 
uses pri ntf and Listing 10-1 uses aDecimalFormat. But in Listing 11-5, 
I display a currency amount. I use the NumberFormat class with its 

getCurrencylnstance method. 

If you compare the formatting statements in Listings 10-1 and 11-5, you don't 
see much difference. 

One listing uses a constructor; the other listing calls 

getCurrencylnstance. 

The getCurrencylnstance method is a good example of what's called 
a factory method. A factory method is a convenient tool for creating 
commonly used objects. People always need code that displays dollar 
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amounts. So the getCurrency Instance method creates a dollar 
format without forcing you to write new Decimal Format 
WO. 00; ($###0.00)"). 



a constructor, a factory method returns a brand-new object. But 
unlike a constructor, a factory method has no special status. When you 
create a factory method, you can name it anything you want. When you 
call a factory method, you don't use the keyword new. 

One listing uses Decimal Format; the other listing uses Number Format. 

A decimal number is a certain kind of number. (In fact, a decimal number is 
a number written in the base-10 system.) Accordingly, the Deci ma 1 Format 
class is a subclass of the NumberFormat class. The Decimal Format 
methods are more specific, so for most purposes, I use Decimal Format. 
But it's harder to use the Decimal Format class's getCurrency Instance 
method. So for programs that involve money, I tend to use NumberFormat. 

Both listings use format methods. 

In the end, you just write something like currency . format ( rate ) or 
dec Form at. format ( average ). After that, Java does the work for you. 



The conditional operator 

Listing 1 1-5 uses an interesting doodad called the conditional operator. This 
conditional operator takes three expressions, and returns the value of just 
one of them. It's like a mini i f statement. When you use the conditional oper- 
ator, it looks something like this: 

condi ti onToBeTested ? expressi onl : expressi on2 

The computer evaluates the condi t i onToBeTested condition. If the condi- 
tion is true, the computer returns the value of express ionl . But, if the 
condition is false, the computer returns the value of express ionZ. 

So, in the code 
smoking ? "yes" : "no" 

the computer checks to see whether smoki ng has the value true. If so, the 
whole three-part expression stands for the first string, "yes ". If not, the 
whole expression stands for the second string, "no". 

In Listing 1 1-5, one of the strings, "yes" or "no", gets displayed by the call to 
out.println. Which string gets displayed depends on whether smoki ng has 
the value true or fa 1 se. 
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f irst stated working with Java, you've been seeing this 
Stri ng a rgs [ ] business in the header of every ma i n method. Well, it's 
high time you found out what that business is all about. 

When you want to run a Java program, you can get the program going by 
choosing BuildOExecute Project or by clicking somewhere else within your 
particular development environment. 

In plenty of situations, clicking is all you need to do. But sometimes, you want 
to add a little extra information as you get the program going. Say, for 
instance, that the program puts a new file on your computer's hard drive. 
Maybe, when you start the program, you want to tell the program what it 
should name that new file. Hey, maybe you give the program even more infor- 
mation. Imagine that this file of yours has random numbers in it. (It's a list of 
numbers to be read aloud at your motel's weekly Bingo game.) When you get 
the program running, you tell the program the name of the new file and how 
many numbers you want the new file to contain. 

All this leads to one big question. How do you give the program some extra 
information each time the program starts running? 

That's where this String args[] business enters the picture. The parame- 
ter a rgs [ ] is an array of Stri ng values. These Stri ng values are called 
command line arguments. 



Listing 1 1-7 shows you how to use command line arguments in your code. 



Listing 1 1 -7: Generate a File of Numbers 

import j ava . uti 1 . Random ; 
import j ava . i o . Fi 1 e ; 
import j ava . i o . Pri ntStream ; 
import j ava . i o . IOExcepti on ; 



Using command tine arguments 
in a JaVa program 



(continued) 
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pass MakeRandomNumsFile 



lie static void main(String args[]) 

throws IOException 

Random generator = new RandomO; 

if ( args . 1 ength < 2) ( 
System .out . pri ntl n 

("Usage: MakeRandomNumsFile filename number") 
System. exit( 1 ) ; 

) 

PrintStream printout = new PrintStream(args[0]) ; 
int numLines = Integer. parselnt(args[l] ) ; 

for (int count = 1; count <= numLines; count++) { 
pri ntOut . pri ntl n ( generator . nextlntC 10 ) + 1); 



In preparing the code for this book's CD-ROM, I tweaked some settings for 
this section's JCreator project. As a result, choosing BuildOExecute Project 
gets you the window shown in Figure 1 1-12. Before executing the code, 
JCreator prompts the user for extra information. In Figure 1 1-12, 1 type two 
extra pieces of information — the MyNumberedFile.txt file and the value 5. 
After clicking OK, the code in Listing 1 1-7 begins running. 



Figure 11-12: 

JCreator 
prompts 
the user 
for com- 
mand line 
arguments. 



Set main method aigiiments 

Main (...) : MyNumberedFile.txt 5 



3Q 



When the code begins running, the args array gets its values. In the main 
method of Listing 11-7, the array component a r g s [ 0 ] automatically takes 
on the value "MyNumberedFi 1 e . txt ", and args [1 ] automatically becomes 
" 5 " . So the program's assignment statements end up having the following 
meaning: 

PrintStream printout = new PrintStreamCMyNumberedFile.txt"); 
int numLines = I nteger . parsel nt ( " 5" ) ; 
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The program creates a file named MyNumberedFile. txt and sets n um L i n e s to 
5. So later in the code, the program randomly generates five values and puts 
ues into My Numbered Fi 1 e . txt. One run of the program gave me the 
in Figure 11-13. 



Figure 11-13: 

A file from 
a run of 
the code in 
Listing 11-7. 



MyNumberedFile.txt 








10 

8 






2 
7 
7 





Notice how each command line argument is a St ri ng value. When you look 
at a r g s [ 1 ] , you don't see the number 5 — you see the string " 5 " with a digit 
character in it. Unfortunately you can't use that " 5 " to do any counting. To 
get an i nt value from "5", you have to apply the pa rsel nt method. 

The pa rsel nt method lives inside a class named Integer. So, to call pa rsel nt, 
you preface the name parselnt with the word Integer. The Integer class has 
all kinds of handy methods for doing things with i nt values. 




In Java, Integer is the name of a class, and int is the name of a primitive (simple) 
type. The two things are related, but they're not the same. The Integer class 
has methods and other tools for dealing with i nt values. 



Checking for the right number 
of command tine arguments 

What happens if the user makes a mistake? What if the dialog box in 
Figure 11-12 (shown previously) pops up and the user forgets to type the 
number 5. The user types MyNumberedFile.txt, and nothing else. 

Then the computer assigns "MyNumberedFile.txt" to args [0 ], but it 
doesn't assign anything to a rgs [ 1 ] . This is bad. If the computer ever reaches 
the statement 

int numLines = Integer. parselnt(args[l] ) ; 

then the program crashes with an unfriendly ArraylndexOutOfBounds 
Excepti on. 
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So, what do you do about this? In Listing 11-7, you check the length of the 
args array. You compare args. length with 2. If the args array has fewer 

components, you display a message on the screen and you exit from 
am. Figure 1 1-14 shows the resulting output. 



Figure 11-14: 

The code in 
Listing 11-7 
tells you 
how to 
run it. 



General Output 




Conf iguration : Listmgll 

Usage : MakeRandomHumsFi le f l lename number 

Process completed. 






Despite the checking of a rgs . 1 ength in Listing 11-7, the code still isn't crash- 
proof. If you type five instead of 5, the program takes a nosedive with a 
NumberFormatExcepti on. The second command line argument can't be a 
word. The argument has to be a number (and a whole number at that). I can 
add statements to Listing 1 1-7 to make the code more bulletproof, but check- 
ing for the NumberFormatExcepti on is better done in Chapter 12. 




When you're working with command line arguments, you can enter a 
Stri ng value with a blank space in it. Just enclose the value in double 
quote marks. For instance, you can run the code of Listing 1 1-7 with 
arguments "My File.txt" 7. 



Setting up JCreator for command tine 
arguments 

Normally, when you choose BuildOExecute Project, the computer starts run- 
ning your code. The computer doesn't wait for you to enter any extra pieces 
of information, so things like an extra filename and the number of values in 
the file can get lost in the dust. To use command line arguments, the com- 
puter has to pause for a moment. During this pause, the computer prompts 
the user to type in a few more bits of information. 

For the code on the CD-ROM, I rigged JCreator to display the dialog box in 
Figure 11-12. But if you're creating a program on your own, how do you tell 
JCreator to pause and prompt the user for information? To find out, follow 
these steps: 
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1. In JCreator's File View pane, find the project whose main program 
uses command line arguments. 

u're using this book's sample code, pick the Listingll07 project. 




Right-click the project's branch in the File View tree. In the resulting 
context menu, choose Sets as Active Project. 

This makes the appropriate project active. 

It's easy to forget Step 2. Don't forget Step 2! 

3. Again, right-click the project's branch in the Fi 1 e Vi ew tree. In the 
resulting context menu, choose Properties. 

A Project Properties window appears. 

4. In the Project Properties window, select the JDK Tools tab. 
(See Figure 11-15.) 



Figure 11-15: 

Preparing to 
copy the 
default Run 
Application 
configura- 
tion. 



Project Properties 

Run : MakeF!.3ndori-if'Ji.im::File 



Output path : m FilesWinox Softwafe\JCteatorV3 LEWyPtoiects\Listing1109 Q 



JDK Profiles JDK Tools Requited Libiaries 



Select Tool Type: Run Application 
" ;Defaull>~ 




5. Make sure that Run Application appears in the Select Tool Type drop- 
down list. 

6. Beneath the Select Tool Type list, select the Default configuration. 

7. Click the Copy button. 

A window titled Tool Configuration : Run Application appears. 

8. In the Tool Configuration window's Name text box, type anything that 
reminds you what this example is all about. 

In Figure 11-16, 1 typed GetCommandLineArguments. 
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Figure 11-16: 

The Tool 
Configura- 
tion window. 



Tool Configuration : Run Application 
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9. In the Tool Configuration window, select the Parameters tab. 

10. Select the Prompt for main Method Arguments check box. 

11. Click OK. 

The Tool Configuration window disappears. Now you're staring at the 
Project Properties window again. 

12. In the Project Properties window, select the check box next to your 
newly created configuration. 

In Figure 11-17, 1 selected my new GetCommandLi neArguments 
configuration. 



Figure 11-17: 

Selecting 
your new 
configura- 
tion. 



Project Properties 
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Output path : m FilesWinox SoftwareUCieatoiV3 LEVMyPtoiects\Listing1 1 09 Q 
JDK Profiles JDK Tools Requited Libiaiies 



Select Tool Type: Run Application 
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13. Click OK. 

Isn't that the way these lists of instructions always seem to end? 



Chapter 11: Using Arrays and Collections to Juggle Values 



After following Steps 1 through 13, your project is changed. Whenever that 
project is the active project, choosing BuildOExecute Project gives you a 
x like the one shown previously in Figure 11-12. 

on the use of command line arguments in environments other than 
see this book's Web site. 

The sun is about to set on this book's discussion of arrays. The next section 
deals with something slightly different. But before you leave the subject of 
arrays, think about this: An array is a row of things, and not every kind of 
thing fits into just one row. Take the motel in this chapter's first few exam- 
ples. The motel rooms, numbered 0 through 9, are in one big line. But what if 
you move up in the world? You buy a big hotel with 50 floors and with 100 
rooms on each floor. Then the data is square shaped. We have 50 rows, and 
each row contains 100 items. Sure, you can think of the rooms as if they're all 
in one big row, but why should you have to do that? How about having a 
two -di mens i ona 1 array? It's a square-shaped array in which each compo- 
nent has two indices — a row number and a column number. Alas, I have no 
space in this book to show you a two-dimensional array (and I can't afford a 
big hotel's prices anyway). But if you visit this book's Web site, you can read 
all about it. 



Usinq Jatfa Collections 

Arrays are nice, but arrays have some serious limitations. Imagine that you 
store customer names in some predetermined order. Your code contains an 
array, and the array has space for 100 names. 

String name[] = new Stri ng[100] ; 
for (int i = 0; i < 100; i++) I 
name[i] = new StringO; 

) 

All is well until, one day, customer number 101 shows up. As your program 
runs, you enter data for customer 101, hoping desperately that the array with 
100 components can expand to fit your growing needs. 

No such luck. Arrays don't expand. Your program crashes with an 

ArraylndexOutOfBoundsException. 

"In my next life, I'll create arrays of length 1,000," you say to yourself. And 
when your next life rolls around, you do just that. 
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String name[] = new Stri ng[1000] ; 
f.or (int i = 0; i < 1000; i++) I 
,me[i ] = new Stri ng ( ) ; 



But during your next life, an economic recession occurs. Instead of having 
101 customers, you have only 3 customers. Now you're wasting space for 
1,000 names when space for 3 names would do. 

And what if no economic recession occurs? You're sailing along with your 
array of size 1,000, using a tidy 825 spaces in the array. The components 
with indices 0 through 824 are being used, and the components with indices 
825 through 999 are waiting quietly to be filled. 

One day, a brand-new customer shows up. Because your customers are 
stored in order (alphabetically by last name, numerically by Social Security 
number, whatever), you want to squeeze this customer into the correct com- 
ponent of your array. The trouble is that this customer belongs very early on 
in the array, at the component with index 7. What happens then? 

You take the name in component number 824 and move it to component 825. 
Then you take the name in component 823 and move it to component 824. 
Take the name in component 822 and move it to component 823. You keep 
doing this until you've moved the name in component 7. Then you put the 
new customer's name into component 7. What a pain! Sure, the computer 
doesn't complain. (If the computer has feelings, it probably likes this kind of 
busy work.) But as you move around all these names, you waste processing 
time, you waste power, and you waste all kinds of resources. 

"In my next life, I'll leave three empty components between every two 
names." And of course, your business expands. Eventually you find that three 
isn't enough. 



Collection classes to the rescue 

The issues in the previous few paragraphs aren't new. Computer scientists 
have been working on these issues for a long time. They haven't discovered 
any magic one-size-fits-all solution, but they've discovered some clever tricks. 

The Java API has a bunch of classes known as collection classes. Each collec- 
tion class has methods for storing bunches of values. And each collection 
class's methods use some clever tricks. For you, the bottom line is as follows: 
Certain collection classes deal as efficiently as possible with the issues raised 
in the previous few paragraphs. If you're writing code, and you know that you 
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have to deal with such issues, you can use these collection classes and call 
the classes' methods. Instead of fretting about a customer whose name 
n position 7, you can just call a class's add method. The method 
e name at a position of your choice, and deals reasonably with 
whatever ripple effects have to take place. In the best circumstances, the 
insertion is very efficient. In the worst circumstances, you can rest assured 
that the code does everything the best way it can. 



Usinq an ArrayList 

The most useful of Java's collection classes is the ArrayList. Listing 11-8 
shows you how it works. 



Listing 1 1 -8: Working with a Java Collection 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . i o . Fi 1 e ; 
import j ava . i o . IOExcepti on ; 
import j ava . uti 1 .Array Li st ; 

class ShowNames I 

public static void main(String args[]) 

throws IOException I 
ArrayLi st<Stri ng> people = new ArrayLi st<Stri ng>( ) ; 

Scanner diskScanner = 

new Scanner(new Fi 1 e( "names . txt" )) ; 

while (diskScanner. hasNext( ) ) { 

peopl e. add(di skScanner . next Li ne( ) ) ; 

) 

peopl e. remove(O) ; 

peopl e. add(2 , "Jim Newton"); 

for (String name : people) { 
out . pri ntl n (name ) ; 

} 




Figure 11-18 shows you a sample names .txt file. The code in Listing 11-8 
reads that names . txt file, and prints the stuff in Figure 11-19. 
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■Barry Burd 






Ri t ter 






J . Katz 


r^Figure THST 


W lH«%ji/"The Crazyman" Spoonswagler 


Felicia "Fishy" Katz 


Several 


Mia, Just "Mia" 


Jeremy 


Fl oof long Jones 


names in 


I. M. D ' Arthur 


a file. 


Hugh R 


DaReader 



Figure 11-19: 

The code in 
Listing 11-8 
changes 
some of the 
names. 



General Output 

Conf igurat ion : 

Harriet Ritter 
Ueelie J . Katz 
Jim Newton 

Harry "The Crazyman" Spoonswagler 

Felicia "Fishy" Katz 

Mia, Just "Mia" 

Jeremy Floof long Jones 

I. M. D ' Arthur 

Hugh R . DaReader 



All the interesting things happen when you execute the remove and add 
methods. The variable named peopl e refers to an ArrayLi st object. When 



you call that object's 


remove method 






peopl e . remove( 0 ) 










you eliminate a value from the lis 
is in the list's initial position (the 
call to remove takes the name Ba 


t. In this case, you eliminate whatever value 
position numbered 0). So in Listing 1 1-8, the 
r ry Burd out of the list. 



That leaves only eight names in the list, but then the next statement, 

peopl e . add( 2 , "Jim Newton"); 

inserts a name into position number 2. (After Barry is removed, position 
number 2 is the position occupied by Harry Spoonswagler, so Harry moves to 
position 3, and Jim Newton becomes the number 2 man.) 

Notice that an Array Li st object has two different add methods. The method 
that adds Jim Newton has two parameters — a position number and a value 
to be added. Another add method 

people.add(diskScanner.nextLine()); 

takes only one parameter. This statement takes whatever name it finds on a 
line of the input file and appends that name to the end of the list. (The add 
method with only one parameter always appends its value to what's cur- 
rently the end of the ArrayLi st object.) 
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Using generics (hot stuff!) 

| ) |^ l"^ ^^j"^^^' 11 at listing an( * notice the funky Array Li st declaration: 

Array Li st<Stri ng> people = new Array Li st<Stri ng> () ; 

In Java 5.0, each collection class is generified. That ugly-sounding word 
means that every declaration should contain <SomeTypeName>. The thing 
that's sandwiched between < and > tells Java what kinds of values the new 
collection may contain. 

For example, in Listing 11-8 the words ArrayList<String> people say that 
the peopl e variable can refer only to a collection of Stri ng values. So from 
that point on, any reference to an item from the people collection is treated 
exclusively as a Stri ng. If you write 

people. add(new RoomO); 

then the compiler coughs up your code and spits it out because a Room isn't 
the same as a St ri ng. (This coughing and spitting happens even if the com- 
piler has access to the Room class's code — the code in Listing 11-5.) But the 
statement 

peopl e . add( "George Gow"); 

is just fine. Because "George Gow" has type Stri ng, the compiler smiles 
happily. 

Testing for the presence of more data 

Here's a pleasant surprise. When you write a program like the one shown pre- 
viously in Listing 1 1-8, you don't have to know how many names are in the 
input file. Having to know the number of names may defeat the purpose of 
using the easily expandable ArrayList class. Instead of looping until you 
read exactly nine names, you can loop until you run out of data. 

The Scanner class has several nice methods like hasNextlnt, 
hasNextDoubl e, and plain old hasNext. Each of these methods checks for 
more input data. If there's more data, the method returns true. Otherwise, 
the method returns f al se. 



Listing 11-8 uses the general purpose hasNext method. This hasNext 
method returns true as long as there's anything more to read from the pro- 
gram's input. So after the program scoops up that last Hugh R. DaReader 
line in Figure 11-18, the subsequent hasNext call returns false. This f a 1 se 
condition ends execution of the while loop and plummets the computer 
toward the remainder of the Listing 1 1-8 code. 
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All about generics 



I design goals was to keep 
the language as simple as possible. The lan- 
guage's developer took some unnecessarily 
complicated features of C++ and tossed them 
out the window. The result was a language that 
was elegant and sleek. Some people said the 
language was too sleek. So after several years 
of discussion and squabbling, Java is becoming 
a bit more complicated. 

In particular, Java 5.0 includes enum types, 
enhanced for loops, static import, and some 
other interesting features. But the most 
talked-about new feature is the introduction of 
generics. 

Array Li st<Stri ng> people = 
new Array Li st<Stri ng> () ; 

The use of anything like <Stri ng> is new in 
Java 5.0. In old-style Java, you'd write 

ArrayList people = 



new ArrayList( ) 



store 
a 



In those days, an ArrayList could 
almost anything you wanted to put in it 
number, an Account, a Room, a Stri ng — 
anything. The ArrayList class was very 
versatile, but with this versatility came some 
headaches. If you could put anything into 
an ArrayList, you couldn't easily predict 
what you would get out of an ArrayLi st. In 
particular, you couldn't easily write code that 
assumed you had stored certain types of values 
in the Array Li st. Here's an example: 



ArrayList things = 

new ArrayLi st( ) ; 
thi ngs . add( new AccountO); 
Account myAccount = 

thi ngs . get ( 0 ) ; 
//DON'T USE THIS. IT'S BAD 

CODE. 

In the third line, the call to get ( 0 ) grabs the 
earliest value inthe thi ngs collection. The call 
to get(0) is okay, but then the compiler 
chokes on the attempted assignment to 
myAccount. You get a message on the third 
line saying that whatever you get from the 
things list can't be stuffed into the 
myAccount variable. You get this message 
because, by the time the compiler reaches the 
third line, it has forgotten that the item added on 
the second line was of type Account! 

The introduction of generics fixes this problem: 

Array Li st<Account> things = 
new Array Li st<Account>( ) ; 

thi ngs . add( new AccountO); 

Account myAccount = 
thi ngs . get ( 0 ) ; 

//USE THIS CODE INSTEAD. IT'S 
GOOD CODE. 

Adding <Account> in two places tells the 
compiler that things stores Account 
instances — nothing else. So, in the third line 
above, you get a value from the thi ngs col- 
lection. Then, because things stores only 
Account objects, you can make myAccount 
refer to that new value. It works! 
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DropBo 6, k oling Good When Things 

Take Unexpected Turns 



In This Chapter 

Recovering from bad input and other nasty situations 
Making your code (more or less) crash proof 
Defining your own exception class 



September 9, 1945: A moth flies into one of the relays of the Harvard Mark 
II computer and gums up the works. This becomes the first recorded case 
of a real computer bug. 

April 19, 1957: Herbert Bright, manager of the data processing center at 
Westinghouse in Pittsburgh, receives an unmarked deck of computer punch 
cards in the mail (which is like getting an unlabeled CD-ROM in the mail today). 
Mr. Bright guesses that this deck comes from the development team for FOR- 
TRAN — the first computer programming language. He's been waiting a few 
years for this software. (No Web downloads were available at the time.) 

Armed with nothing but this good guess, Bright writes a small FORTRAN pro- 
gram and tries to compile it on his IBM 704. (The IBM 704 lives in its own spe- 
cially built, 2,000-square-foot room. With vacuum tubes instead of transistors, 
the machine has a whopping 32K of RAM. The operating system has to be 
loaded from tape before the running of each program, and a typical program 
takes between two and four hours to run.) After the usual waiting time, Bright's 
attempt to compile a FORTRAN program comes back with a single error — a 
missing comma in one of the statements. Bright corrects the error, and the 
program runs like a charm. 

July 22, 1962: Mariner I, the first U.S. spacecraft aimed at another planet, is 
destroyed when it behaves badly four minutes after launch. The bad behav- 
ior is attributed to a missing bar (like a hyphen) in the formula for the rocket's 
velocity. 
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Around the same time, orbit computation software at NASA is found to contain 
the incorrect statement DO 10 1 = 1.10 (instead of the correct DO 10 1 = 1,10). 
ri notation, this is like writing dolOi = 1 . 10 in place of for (int 
10; i ++) . The change from a comma to a period turns a loop into an 
assignment statement. 



January 1, 2000: The Year 2000 Problem wreaks havoc on the modern world. 

Any historically accurate facts in these notes were borrowed from the follow- 
ing sources: the Computer Folklore newsgroup (al t. f ol kl ore .computers, 
which you can access through groups . googl e . com), the Free On-line Dic- 
tionary of Computing (www .foldoc.org), the "Looking Back" column in 
Computer magazine (www .computer . org/computer), and the Web pages of 
the IEEE (www .computer. org/ hi story). 



Handling Exceptions 

You're taking inventory. This means counting item after item, box after box, 
and marking the numbers of such things on log sheets, in little handheld 
gizmos, and into forms on computer keyboards. A particular part of the pro- 
ject involves entering the number of boxes that you find on the Big Dusty 
Boxes That Haven't Been Opened Since Year One shelf. Rather than break the 
company's decades-old habit, you decide not to open any of these boxes. You 
arbitrarily assign the value $3.25 to each box. 

Listing 12-1 shows the software to handle this bit of inventory. The software 
has a flaw, which is revealed in Figure 12-1. When the user enters a whole 
number value, things are okay. But when the user enters something else (like 
the number 3.5), the program comes crashing to the ground. Surely something 
can be done about this. Computers are stupid, but they're not so stupid that 
they should fail royally when a user enters an improper value. 



Listing 12-1: Counting Boxes 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . text . NumberFormat ; 

class InventoryA I 

public static void main(String args[]) { 
final double boxPrice = 3.25; 
Scanner myScanner = new Scanner ( System . i n ) ; 
NumberFormat currency = 

NumberFormat.getCurrencylnstanceO; 
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out . pri nt( "How many boxes do we have? "); 

String numBoxesIn = myScanner . nextC ) ; 

int numBoxes = Integer. parselntCnumBoxesIn) ; 

out . pri ntC "The value is "); 

out.printlnCcurrency. format C numBoxes * boxPri ce ) ) ; 



Figure 12-1: 

Oops! 
That's not 
a number. 



PI Workspace 'Chapterl 2': 1 Project 
General Output 

Conf igurat 

How many boxes do we have? 3 
The value is S9.75 

Process completed. 
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Conf igurat ion : Li sting 1201 - j 2sdkl .5.0 -a 

How many boxes do we have? 3 . 5 

java . lang . HumberFormat Except ion : For input string : " 3 

at java . lang . NumberFormat Except ion . f orlnputStrmg(Hu) 
at java . lang . Integer . parselnt (Integer . java : 455 ) 
at java . lang . Integer . parselnt ( Integer . java :49b) 
at InventoryA . main( InventoryA . java : 15 ) 

Exception in thread "main" 

Process completed. 

<1 1L 

H General Output 
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How many boxes do we have? three 
java . lang . NumberFormatException : For input string : " three" 

at java . lang . HumberFormat Except ion . f orInputString(HumberFormatExcept ion . java : 
at java . lang . Integer parselnt ( Integer java : 446 ) 
at java . lang . Integer . parselnt ( Integer . java : 496 ) 
at InventoryA . main ( InventoryA . java : 15 ) 
Exception in thread "main" 
Process completed. 



The key to fixing a program bug is examining the message that appears when 
the program crashes. The inventory program's message says j a v a . 1 a n g . 
NumberFormatExcepti on. That means a class named NumberFormatException 
is in the java . 1 ang API package. Somehow, the call to Integer. parselnt 




brought this NumberFormatExcepti on class out of hiding. 

For a brief explanation of the Integer. parselnt method, see Chapter 1 1 . 

Well, here's what's going on. The Java programming language has a mechanism 



called exception handling. With exception handling, a program can detect that 
things are about to go wrong and respond by creating a brand-new object. In 
the official terminology, the program is said to be throwing an exception. That 
new object, an instance of the Excepti on class, is passed like a hot potato 
from one piece of code to another until some piece of code decides to catch the 
exception. When the exception is caught, the program executes some recovery 
code, buries the exception, and moves on to the next normal statement as if 
nothing had ever happened. The process is illustrated in Figure 12-2. 

The whole thing is done with the aid of several Java keywords. These key- 
words are as follows: 

i>* throw: Creates a new exception object. 

i>* throws: Passes the buck from a method up to whatever code called the 
method. 
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I try: Encloses code that has the potential to create a new exception 

object. In the usual scenario, the code inside a t ry clause contains calls 
methods whose code can create one or more exceptions. 

fch: Deals with the exception, buries it, and then moves on. 

So, the truth is out. Through some chain of events like the one shown in 
Figure 12-2, the method Integer, parse I nt can throw a Number Format 
Excepti on. When you call Integer . parselnt, this NumberFormatExcepti on 
is passed on to you. 




The Java API (Application Programming Interface) documentation for the 
parselnt method says, "Throws: NumberFormatExcepti on — if the string 
does not contain a parsable integer." Once in a while, reading the documenta- 
tion actually pays. 



If you call yourself a hero, you'd better catch the exception so that all the other 
code can get on with its regular business. Listing 12-2 shows the catching of 
an exception. 



DropBook 



void methodl ( ) { 
try { 

metho<32 ( ) ; - 



} catch (Exception e) { 



void method2 ( ) throws Exception { 
method3 ( ) ; •* 

} 



void method3 ( ) 
method4 ( ) ; 

} 



throws Exception { 



Figure 12-2: 

Throwing, 
passing, and 
catching an 
exception. 



void method4 ( ) throws Exception { 
throw new Exception () ; 
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i|np_p_rt static Java . 1 ang . System . out ; 
Java. uti 1 . Scanner ; 
Java. text. NumberFormat; 

class InventoryB I 

public static void mainCString args[]) { 
final double boxPrice = 3.25; 
Scanner myScanner = new Scanner ( System . i n ) ; 
NumberFormat currency = 

NumberFormat .getCurrencylnstanceO; 

out . pri nt ( "How many boxes do we have? "); 
String numBoxesIn = myScanner . next () ; 

try { 

int numBoxes = Integer . parselnt( numBoxesIn ) ; 
out . pri nt ( "The value is "); 

out . pri ntl n ( currency . format (numBoxes * boxPrice)) 
} catch ( NumberFormatExcepti on e) { 

out . pri ntl n ( "That ' s not a number."); 

} 



Figure 12-3 shows three runs of the code from Listing 12-2. When a misguided 
user types three instead of 3, the program maintains its cool by displaying 
That's not a number. The trick is to enclose the call to Integer . pa rselnt 
inside a try clause. When you do this, the computer watches for exceptions 
when any statement inside the try clause is executed. If an exception is 
thrown, the computer jumps from inside the t ry clause to a c a t c h clause 
below it. In Listing 12-2, the computer jumps directly to the catch (Number 
FormatExcepti on e) clause. The computer executes the pri ntl n statement 
inside the clause, and then marches on with normal processing. (If there were 
statements in Listing 12-2 after the end of the catch clause, the computer 
would go on and execute them.) 



Figure 12-3: 

Catch that 
exception. 



□enerai I Jin [jut *| '-' 

Configure General Output 

How many boxes do we nave < j 
The value is $9.75 

- 1 : 



How many boxes do we have? three 
That ' s not a number . 



Process comp 1 e t ed . 



General Output 

Conf iguratic 

How many boxes do we have? -25 
The value is ($81 . 25) 



An entire t ry-c a t c h assembly, complete with a t ry clause, catch clause, and 
what have you, is called a try statement. Sometimes, for emphasis, I call it a 
try-catch statement. 
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ok at the catch clause in Listing 12-2 and pay particular attention to 
s ( Numb erFormatExcept ion e). This looks a lot like a method's 
parameter list, doesn't it? In fact, every catch clause is like a little mini-method 
with its own parameter list. The parameter list always has an exception type 
name and then a parameter. 

In Listing 12-2, 1 don't do anything with the catch clause's e parameter, but I 
certainly could if I wanted to. Remember, the exception that's thrown is an 
object — an instance of the NumberFormatException class. When an excep- 
tion is caught, the computer makes the catch clause's parameter refer to that 
exception object. In other words, the name e stores a bunch of information 
about the exception. To take advantage of this, you can call some of the 
exception object's methods. 



) catch (NumberFormatException e) { 

out . pri ntl n ( "That ' s not a number."); 

out . pri ntl n ( "Message : " + e.getMessage( ) ) ; 

out . pri ntl n ( "Here comes a stack trace: "); 
e.printStackTrace( ) ; 

out . pri ntl n ( "Di d you like the stack trace?"); 



With this enhanced catch clause, a run of the i n ventory program may look 
like the run shown in Figure 12-4. When you call getMessage, you fetch some 
detail about the exception. (In Figure 12-4, the detail is the fact that the user 
mistakenly typed the word three?) When you call pri ntStackT race, you get a 
display showing the methods that were running at the moment when the 
exception was thrown. (In Figure 1 2-4, the display includes Integer. parselnt 
and the mai n method.) Both getMessage and pri ntStackTrace present infor- 
mation to help you find the source of the program's difficulties. 



Figure 12-4: 

Calling an 
exception 
object's 
methods. 



How many boxes do we have? three 
That's not a number. 
Message: For input string: "three" 
Here comes a stack trace: 

java lang NumberFormatException: For input string: "three" 

at java . lang. NumberFormatExcept ion f or InputStnng(tlumberFormat Except ion . ]ava : 48 ) 

at java lang Integer parselnt ( Integer java : 446 ) 

at java . lang . Integer . parselnt ( Integer . java : 496 ) 

at InventoryB . main( InventoryB . java : 17 ) 
Did you like the stack trace? 

Process completed 
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lse can go wrong today? Are there other kinds of exceptions — 
at don't come from the NumberFormatExcepti on class? Sure, plenty 
of different exception types are out there. You can even create one of your own. 
You wanna try? If so, look at Listings 12-3 and 12-4. 

Listing 1 2-3: Making Your Own Kind of Exception 

class OutOf RangeExcepti on extends Exception ( 



Listing 1 2-4: Using Your Custom Made Exception 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . text . NumberFormat ; 

class InventoryC ( 

public static void main(String args[]) { 
final double boxPrice = 3.25; 
Scanner myScanner = new Scanner ( System . i n ) ; 
NumberFormat currency = 

NumberFormat .getCurrencylnstanceO; 

out . pri nt ( "How many boxes do we have? "); 
String numBoxesIn = myScanner . next () ; 

try { 

int numBoxes = Integer . parselnt( numBoxesIn ) ; 

if (numBoxes < 0) { 

throw new OutOf RangeExcepti on( ) ; 

} 

out . pri nt ( "The value is "); 

out . pri ntl n ( currency . format (numBoxes * boxPrice)) 
) catch ( NumberFormatExcepti on e) I 

out . pri ntl n ( "That ' s not a number."); 
} catch (OutOf RangeExcepti on e) { 

out.print(numBoxesIn) ; 

out . pri ntl n( "? That's impossible!"); 
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Listings 12-3 and 12-4 remedy a problem that cropped up in Figure 12-3. Look 
at the last of the three runs in Figure 12-3. The user reports that the shelves 
boxes, and the computer takes this value without blinking an eye. 
is that you would need a black hole (or some other exotic space- 
time warping phenomenon) to have a negative number of boxes on any shelf 
in your warehouse. So the program should get upset if the user enters a nega- 
tive number of boxes, which is what the code in Listing 12-4 does. To see the 
upset code, look at Figure 12-5. 



Figure 12-5: 

Running the 
code from 
Listings 12-3 
and 12-4. 



rut view 
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Configur; General Output 

How many boxes do we have? 3 

The value is $9 . 75 



-Conf iguratior 
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How many boxes do we have? three 
That's not a number 



General Uutput " 

Conf iguratic 

How many boxes do we have? -25 
-25? That ' s impossible ! 



The code in Listing 12-3 declares a new kind of exception class — OutOfRange 
Except i on. In many situations, typing a negative number would be just fine, so 
OutOf RangeExcepti on isn't built into the Java API. However, in the inventory 
program, a negative number should be flagged as an anomaly. 

The OutOfRangeException class in Listing 1 2-3 wins the award for the short- 
est self-contained piece of code in the book. The class's code is just a declara- 
tion line and an empty pair of braces. The code's operative phrase is extends 
Except ion. Being a subclass of the Java API Except i on class allows any 
instance of the OutOf RangeExcepti on class to be thrown. 

Back in Listing 12-4, a new OutOf RangeExcepti on instance is thrown. When 
this happens, the catch clause (OutOfRangeException e) catches the 
instance. The clause echoes the user's input and displays the message That's 
impossi bl e ! 



Who's tyoinq to catch the exception} 

Take one more look at Listing 12-4. Notice that more than one catch clause 
can accompany a single t ry clause. When an exception is thrown inside a 
try clause, the computer starts going down the accompanying list of catch 
clauses. The computer starts at whatever catch clause comes immediately 
after the try clause and works its way down the program's text. 
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For each catch clause, the computer asks itself, "Is the exception that was just 
thrown an instance of the class in this clause's parameter list?" 



t, the computer skips this catch clause and moves on to the next 
catch clause in line. 

**" If so, the computer executes this catch clause and then skips past all 
the other catch clauses that come with this try clause. The computer 
goes on and executes whatever statements come after the whole try- 
catch statement. 



For some concrete examples, see Listings 12-5 and 12-6. 



Listing 12-5: Yet Another Exception 



class NumberTooLargeExcepti on extends OutOf RangeExcepti on { 
) 



Listing 1 2-6: Where Does the Buck Stop? 

import static Java . 1 ang . System. out ; 
import j ava . uti 1 . Scanner ; 
import j ava . text . NumberFormat ; 

class InventoryD ( 

public static void main(String args[]) { 
final double boxPrice = 3.25; 
Scanner myScanner = new Scanner (System . i n ) ; 
NumberFormat currency = 

NumberFormat .getCurrencylnstanceO; 

out . pri nt ( "How many boxes do we have? "); 
String numBoxesIn = myScanner . next () ; 

try { 

int numBoxes = Integer . parselnt( numBoxesIn ) ; 

if (numBoxes < 0) { 

throw new OutOf RangeExcepti on( ) ; 

} 

if (numBoxes > 1000) { 

throw new NumberTooLargeExceptionO ; 

} 

out . pri nt ( "The value is "); 

out . pri ntl n ( currency . format (numBoxes * boxPrice)); 

} 



(continued) 
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Listing 1 2-6 (continued) 
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catch (NumberFormatExcepti on e) { 

out.printlnC'That's not a number."); 



catch (OutOf RangeExcepti on e) { 
out.print(numBoxesIn) ; 
out . pri ntl n( "? That's impossible!"); 

} 

catch (Exception e) { 

out. print( "Something went wrong, "); 
out.printC'but I'm clueless about what "); 
out.printlnC'it actually was."); 



To run the code in Listings 12-5 and 12-6, you need one additional Java program 
file. You need the OutOf RangeExcepti on class in Listing 12-3. 

Listing 12-6 addresses the scenario in which you have limited shelf space. You 
don't have room for more than 1,000 boxes, but once in a while, the program 
asks how many boxes you have, and somebody enters the number 100000 by 
accident. In cases like this, Listing 12-6 does a quick reality check. Any number 
of boxes over 1,000 is tossed out as being unrealistic. 

Listing 12-6 watches for a NumberTooLargeExcepti on, but to make life more 
interesting, Listing 1 2-6 doesn't have a c a t c h clause for the NumberTooLarge 
Except! on. In spite of this, everything still works out just fine. It's fine 
because NumberTooLargeExcepti on is declared to be a subclass of OutOf 
RangeExcepti on, and Listing 12-6 has a catch clause for the OutOf Range 
Excepti on. 

You see, because NumberTooLargeExcepti on is a subclass of OutOf Range 
Excepti on, any instance of NumberTooLargeExcepti on is just a special kind 
of OutOf RangeExcepti on. So in Listing 12-6, the computer may start looking 
for a clause to catch a NumberTooLargeExcepti on. When the computer 
stumbles upon the OutOf RangeExcepti on catch clause, the computer says, 
"Okay, I've found a match. I'll execute the statements in this catch clause." 

To keep from having to write this whole story over and over again, I introduce 
some new terminology. I say that the catch clause with parameter OutOf Range 
Excepti on matches the NumberTooLargeExcepti on that's been thrown. I call 
this catch clause a matching catch clause. 



out 



pri ntl n ( "That ' s that."); 
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The following bullets describe different things that the user may do and how 
the computer responds. As you read through the bullets, you can follow along 
g at the runs shown in Figure 12-6. 



Figure 12-6: 

Running the 
code from 
Listing 12-6. 



General Output 

Conf igura 

How many boxes do we have? 3 
The value is S9 . 75 
That ' s that 
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General Output 
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How many boxes do we have? -25 
-25? That's impossible! 
That's that. 



Conf igura 

How many boxes do we have? f ish 
That ' s not a number 
That ' s that 



□ General Output 



[S Build Output | [3 Task Lis 



Conf igurat i or 

How many boxes do we have? 1001 
1001? That's impossible! 
That 1 s that . 



["iRpnpral Outnilt I TO Build nutnut FTlTa- Process completed. 



V The user enters an ordinary whole number, like the number 3. 

All the statements in the try clause are executed. Then the computer 
skips past all the catch clauses and executes the code that comes 
immediately after all the catch clauses. (See Figure 12-7.) 



try { 



//Normal processing (throw no exception) 



catch (NumberFormatException e) { 

out .println ( "That ' s not a number."),- 

} 

catch (OutOfRangeException e) { 
out .print (numBoxes In) ; 
out .println (" ? That's impossible!"); 

} 



Figure 12-7: 

No 

exception 
is thrown. 



catch (Exception e) { 

out .print ( "Something went wrong, "); 

out .print ( "but I'm clueless about what ") 

out. println ( "it actually was."); 

} 

out .println ( "That ' s that."); 
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The user enters something that's not a whole number, like the word 
fish. 
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code throws a NumberFormatExcepti on. The computer skips past 
emaining statements in the try clause. The computer executes the 
statements inside the first catch clause — the clause whose parameter 
is of type NumberFormatExcepti on. Then the computer skips past the 
second and third catch clauses and executes the code that comes 
immediately after all the catch clauses. (See Figure 12-8.) 



try { 



throw new NumberFormatException (); 



catch (NumberFormatException e) { 

out .println ( "That ' s not a number."); 

} 

catch (OutOfRangeException e) { 
out .print (numBoxes In) ,- 
out .println (" ? That's impossible!"); 

} 



Figure 12-8: 

A Number 
Format 
Exception is 
thrown. 



catch (Exception e) { 

out . print (" Something went wrong, "),- 
out .print ( "but I'm clueless about what 
out .println (" it actually was."); 

} 

out .println ( "That ' s that . " ) ; 



V The user enters a negative number, like the number -25. 

The code throws an OutOfRangeException. The computer skips past 
the remaining statements in the try clause. The computer even skips 
past the statements in the first catch clause. (After all, anOutOfRange 
Excepti on isn't any kind of a NumberFormatExcepti on. The catch 
clause with parameter NumberFormatException isn'ta match for this 
OutOf RangeExcepti on.) The computer executes the statements inside 
the second catch clause — the clause whose parameter is of type 
OutOf RangeExcepti on. Then the computer skips past the third catch 
clause and executes the code that comes immediately after all the catch 
clauses. (See Figure 12-9.) 
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Figure 12-9: 

An 

OutOfRange 
Exception is 
thrown. 



try { 



- throw new OutOf RangeExcept ion ( ) ; 



catch (NumberFormatException e) { 

out .print In ( "That ' s not a number."),- 

} 

catch (OutOf RangeException e) { 
out .print (numBoxes In) ,- 
out .println ( " ? That's impossible!"); 

} 

catch (Exception e) { 

out . print (" Something went wrong, " ) ; 
out .print ( "but I'm clueless about what 
out .println (" it actually was."); 

} 

out .println ( "That ' s that . " ) ; 



t<" The user enters an unrealistically large number, like the number 1001. 

The code throws a NumberTooLargeExcepti on. The computer skips past 
the remaining statements in the t ry clause. The computer even skips past 
the statements in the first catch clause. (After all, a NumberTooLa rge 
Excepti on isn't any kind of NumberFormatExcepti on.) 

But, according to the code in Listing 12-5, NumberTooLargeExcepti on 
isasubclassofOutOfRangeException. When the computer reaches 
the second catch clause, the computer says, "Hmm! A NumberTooLa rge 
Excepti on is a kind of OutOf RangeExcepti on. I'll execute the state- 
ments in this catch clause — the clause with parameter of type OutOf 
RangeExcepti on." In other words, it's a match. 

So, the computer executes the statements inside the second catch clause. 
Then the computer skips the third catch clause and executes the code 
that comes immediately after all the catch clauses. (See Figure 12-10.) 

V Something else, something very unpredictable happens (I don't know 
what). 

With my unending urge to experiment, I reached into the t ry clause of 
Listing 12-6 and added a statement that throws an 10 Excepti on. No 
reason — I just wanted to see what would happen. 
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Figure 12-10: 

A Number 
TooLarge 
Exception is 
thrown. 



try { 



- throw new NumberTooLargeExcept ion ( ) ; 



catch (NumberFormatException e) { 

out .print In ( "That ' s not a number."),- 

} 

catch (OutOf RangeException e) { 
out .print (numBoxes In) ,- 
out .println ( " ? That's impossible!"); 

} 

catch (Exception e) { 

out . print (" Something went wrong, " ) ; 
out .print ( "but I'm clueless about what 
out .println (" it actually was."); 

} 

out .println ( "That ' s that."); 



When the code threw an IOException, the computer skipped past the 
remaining statements in the try clause. Then the computer skipped 
past the statements in the first and second catch clauses. When the 
computer reached the third catch clause, I could hear the computer 
say, "Hmm! An IOExcepti on is a kind of Excepti on. I've found a match- 
ing catch clause — a clause with a parameter of type Excepti on. I'll 
execute the statements in this catch clause." 

So, the computer executed the statements inside the third catch clause. 
Then the computer executed the code that comes immediately after all 
the catch clauses. (See Figure 12-11.) 

When the computer looks for a matching catch clause, the computer latches 
on to the topmost clause that fits one of the following descriptions: 

V The clause's parameter type is the same as the type of the exception 
that was thrown. 

The clause's parameter type is a superclass of the exception's type. 
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Figure 12-11: 

An 

lOException 
is thrown. 



try { 



throw new lOException (); 



catch (NumberFormatException e) { 

out .print In ( "That ' s not a number."),- 

} 

catch (OutOf RangeException e) { 
out .print (numBoxes In) ,- 
out .println ( " ? That's impossible!"); 

} 

catch (Exception e) { 

out . print (" Something went wrong, " ) ; 
out .print ( "but I'm clueless about what 
out .println (" it actually was."); 

} 

out .println ( "That ' s that."); 



If a better match appears farther down the list of catch clauses, that's just too 
bad. For instance, imagine that you added a catch clause with a parameter of 
type NumberTooLargeExcepti on to the code in Listing 12-6. Imagine, also, that 
you put this new catch clause after the catch clause with parameter of type 
OutOf RangeExcepti on. Then, because NumberTooLargeExcepti on is a sub- 
class of the OutOf RangeExcepti on class, the code in your new NumberToo 
LargeExcepti on clause would never be executed. That's just the way the 
cookie crumbles. 



Throurinq caution to the Wind 

Are you one of those obsessive-compulsive types? Do you like to catch every 
possible exception before the exception can possibly crash your program? 
Well, watch out. Java doesn't let you become paranoid. You can't catch an 
exception if the exception has no chance of being thrown. 

Consider the following code. The code has a very innocent i ++ statement 
inside a try clause. That's fair enough. But then the code's catch clause is 
pretending to catch an lOException. 



Part IV: Savvy Java Techniques 



// Bad code! 



dBooIcs 

e.i 



_ih (IOException e) I 
e"". printStackTrace(); 



Who is this catch clause trying to impress? A statement like i++ doesn't do 
any input or output. The code inside the try clause can't possibly throw an 
IOExcepti on. So the compiler comes back and says, "Hey, catch clause. Get 
real. Get off your high horse." Well, to be a bit more precise, the compiler's 
reprimand reads as follows: 

exception Java . i o . IOExcepti on is never thrown in body of 
corresponding try statement 



Da inq useful things 

So far, each example in this chapter catches an exception, prints a "bad input" 
message, and then closes up shop. Wouldn't it be nice to see a program that 
actually carries on after an exception has been caught? Well, it's time for some- 
thing nice. Listing 12-7 has a try-catch statement inside a loop. The loop 
keeps running until the user types something sensible. 



Listing 12-7: Keep Pluggin' Along 

import static Java . 1 ang . System . out ; 
import j ava . uti 1 . Scanner ; 
import j ava . text . NumberFormat ; 



class InventoryLoop { 

public static void main(String args[]) { 
final double boxPrice = 3.25; 
boolean gotGoodlnput = false; 
Scanner myScanner = new Scanner ( System . i n ) ; 
NumberFormat currency = 

NumberFormat.getCurrencylnstanceO; 



do ( 

out . pri nt( "How many boxes do we have? "); 
String numBoxesIn = myScanner . next( ) ; 

try ( 

int numBoxes = Integer . parsel nt( numBoxesIn ) ; 
out . pri nt( "The value is "); 



Chapter 12: Looking Good When Things Take Unexpected Turns 



out . pri ntl n 

( currency . format ( numBoxes * boxPrice)); 
gotGoodl nput = true; 
catch ( NumberFormatExcepti on e) { 
out . pri ntl n ( ) ; 

out . pri ntl n ( "That ' s not a number."); 
e ( IgotGoodlnput) ; 
out . pri ntl n ( "That ' s that."); 

) 

) 

Figure 12-12 shows a run of the code from Listing 12-7. In the first three 
attempts, the user types just about everything except a valid whole number. 
At last, the fourth attempt is a success. The user types 3, and the computer 
leaves the loop. 



-Conf igurat ion : 
How many boxes do we have? 3 . 5 

That ' s not a number . 

How many boxes do we have? three 

That 1 s not a number . 

How many boxes do we have? f ish 

That ' s not a number . 

How many boxes do we have? 3 

The value is $9.75 

That ' s that . 

Process completed. 



Our friends, the qood exceptions 

A rumor is going around that Java exceptions always come from unwanted, 
erroneous situations. Although there's some truth to this rumor, the rumor 
isn't entirely accurate. Occasionally, an exception arises from a normal, 
expected occurrence. Take, for instance, the detection of the end of a file. 
The following code makes a copy of a file: 

try I 

while (true) I 

data Out . wri teByte(dataIn . read Byte ( ) ) ; 

) 

) catch ( EOFExcepti on e) { 
numFi 1 esCopi ed = 1; 

) 
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Figure 12-12: 

A run of 
the code in 
Listing 12-7. 
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To copy bytes from data In todataOut, you just go into awhile loop. With 
its true condition, the whi 1 e loop is seemingly endless. But eventually, you 
end of the data I n file. When this happens, the readBy te method 
EOFExcepti on (an end-of-file exception). The throwing of this 
exception sends the computer out of the t ry clause and out of the while 
loop. From there, you do whatever you want to do in the catch clause, and 
then proceed with normal processing. 



Handle an Exception or Pass the Buck 

So you're getting to know Java, hey? What? You say you're all the way up to 
Chapter 12? 

I'm impressed. You must be a hard worker. But remember, all work and no 
play. . . . 

So, how about taking a break? A little nap could do you a world of good. Is ten 
seconds okay? Or is that too long? Better make it five seconds. 

Listing 12-8 has a program that's supposed to pause its execution for five sec- 
onds. The problem is that the program in Listing 12-8 is incorrect. Take a look 
at Listing 12-8 for a minute, and then I'll tell you what's wrong with it. 

Listing 12-8: An Incorrect Program 

/* 

* This code does not compile. 
*/ 

import static Java . 1 ang . System . out ; 

class NoSl eepForTheWeary { 

public static void main(String args[]) { 
out . pri nt( " Excuse me while I nap "); 
out . pri ntl n ( "f or just five seconds..."); 

takeANap( ) ; 

out . pri ntl n ( "Ah , that was refreshing."); 

) 

static void takeANapO { 
Thread. sleep(5000) ; 

) 

) 
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The strategy in Listing 12-8 isn't bad. The idea is to call the si eep method, 
which is defined in the Java API. This si eep method belongs to the API 

lass. When you call the si eep method, the number that you feed it 
er of milliseconds. So, Thread .sleep ( 5000 ) means pause for five 

seconds. 



The problem is that the code inside the si eep method can throw an excep- 
tion. This kind of exception is an instance of the InterruptedException 
class. When you try to compile the code in Listing 12-8, you get the following 
unwanted message: 

unreported exception Java . 1 ang . InterruptedExcepti on ; must be 
caught or declared to be thrown 

For the purpose of understanding exceptions in general, you don't need to 
know exactly what an InterruptedExcepti on is. All you really have to know 
is that a call to Thread. sleep can throw one of these InterruptedExcepti on 
objects. But if you're really curious, an InterruptedExcepti on is thrown 
when some code interrupts some other code's sleep. Imagine that you have 
two pieces of code running at the same time. One piece of code calls the 
Thread. sleep method. At the same time, another piece of code calls the 
i nterrupt method. By calling the i nterrupt method, the second piece of 
code brings the first code's Thread . si eep method to a screeching halt. The 
Thread. sleep method responds by spitting out an I nterrupted Except ion. 

Now, the Java programming language has two different kinds of exceptions. 
They're called checked and unchecked exceptions: 

f* The potential throwing of a checked exception must be acknowledged in 
the code. 

W The potential throwing of an unchecked exception doesn't need to be 
acknowledged in the code. 

An InterruptedExcepti on is one of Java's checked exception types. When 
youcallamethodthathasthe potential to throw an InterruptedException, 
you need to acknowledge that exception in the code. 

Now, when I say that an exception is acknowledged in the code, what do I 
really mean? 

// The author wishes to thank that InterruptedException, 
// without which this code could not have been written. 




No, that's not what it means to be acknowledged in the code. Acknowledging 
an exception in the code means one of two things: 
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The statements (including method calls) that can throw the exception 
are inside a try clause. That try clause has a catch clause with a 



ching exception type in its parameter list. 



statements (including method calls) that can throw the exception 
are inside a method that has a throws clause in its header. The throws 
clause contains a matching exception type. 

If you're confused by the wording of these two bullets, don't worry. The next 
two listings illustrate the points made in the bullets. 

In Listing 1 2-9, the method call that can throw an InterruptedException is 
inside a try clause. That try clause has a catch clause with exception type 

Interrupted Except ion. 



Listing 1 2-9: Acknowledging with a try-catch Statement 

import static Java . 1 ang . System . out ; 

class GoodNi ghtsSl eepA { 

public static void main(String args[]) { 
out . pri nt( " Excuse me while I nap "); 
out . pri ntl n ( "f or just five seconds..."); 

takeANapC ) ; 

out . pri ntl n ( "Ah , that was refreshing."); 

) 

static void takeANapC) ( 
try { 

Thread. sleep(5000) ; 
} catch (InterruptedException e) { 

out . pri ntl n ( "Hey , who woke me up?"); 

} 

) 



It's my custom, at this point in a section, to remind you that a run of Listing 
Such-and-Such is shown in Figure So-and-So. But the problem here is that 
Figure 12-13 doesn't do justice to the code in Listing 12-9. When you run the 
program in Listing 12-9, the computer displays Excuse me while I nap for 
just five seconds, pauses for five seconds, and then displays Ah , that 
was refreshing. The code works because the call to the s 1 e e p method , 
which can throw an InterruptedExcepti on, is inside a try clause. That try 
clause has a catch clause whose exception is of type InterruptedExcepti on. 
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Figure 12-13: 

pause 
before the 
"Ah" line. 




^ Conf iguration ; 

kwhile I nap for just f iv 
las refreshing 



Listingl209 
: seconds . . . 



Process completed . 



So much for acknowledging an exception with a try-catch statement. You can 
acknowledge an exception another way, which is used in Listing 12-10. 



Listing 12-10: Acknowledging with throws 




import static Java . 1 ang . System . out ; 

class GoodNi ghtsSl eepB { 

public static void main(String args[]) { 
out . pri nt( " Excuse me while I nap "); 
out . pri ntl n ( "f or just five seconds..."); 

try 1 




takeANap( ) ; 
) catch (Interrupt 
out . pri ntl n ( "h 

) 

out . pri ntl n ( "Ah , t 

) 

static void takeANapO 
Thread. sleep(5000) 

) 

) 


edException e) ( 

ey , who woke me up? " ) ; 

hat was ref reshi ng . " ) ; 

throws InterruptedExcepti on ( 



To see a run of the code in Listing 12-10, refer to Figure 12-13. Once again, 
Figure 12-13 fails to capture the true essence of the run, but that's okay. Just 
remember that in Figure 12-13, the computer pauses for five seconds before it 
displays Ah , that was refreshing. 



The important part of Listing 12-10 is in the takeANap method's header. That 
header ends with th rows I nterruptedExcepti on. By announcing that it 
throws an InterruptedExcepti on, method takeANap passes the buck. What 
this throws clause really says is, "I realize that a statement inside this method 
has the potential to throw an I nterruptedExcepti on, but I'm not acknowl- 
edging the exception in a try-catch statement. Java compiler, please don't 
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bug me about this. Instead of having a try-catch statement, I'm passing the 
responsibility for acknowledging the exception to the main method (the 
hat called the takeANap method)." 

i the mai n method, the call to takeANap is inside a try clause. 
That try clause has a catch clause with a parameter of type I interrupted 
Excepti on. So everything is okay. Method takeANap passes the responsibil- 
ity to the main method, and the ma i n method accepts the responsibility with 
an appropriate try-catch statement. Everybody's happy. Even the Java com- 
piler is happy. 
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To better understand the throws clause, imagine a volleyball game in which 
the volleyball is an exception. When a player on the other team serves, that 
player is throwing the exception. The ball crosses the net and comes right to 
you. If you pound the ball back across the net, you're catching the exception. 
But if you pass the ball to another player, you're using the throws clause. In 
essence, you're saying, "Here, other player. You deal with this exception." 




A statement in a method can throw an exception that's not matched by a 
catch clause. This includes situations in which the statement throwing the 
exception isn't even inside a t ry block. When this happens, execution of the 
program jumps out of the method that contains the offending statement. 



Execution jumps back to whatever code called the method in the first place. 




A method can name more than one exception type in its throws clause. Just 
use commas to separate the names of the exception types, like in the follow- 
ing example: 



throws I nterruptedExcepti on , IOException, Ari thmeti cExcepti on 

The Java API has hundreds of exception types. Several of them are subclasses 
of the RuntimeExcepti on class. Anything that's a subclass of Runtime 
Excepti on (or a sub-subclass, sub-sub-subclass, and so on) is unchecked. 
Any exception that's not a descendent of RuntimeExcepti on is checked. The 
unchecked exceptions include things that would be hard for the computer to 
predict. Such things include the NumberFormatExcepti on (of Listings 12-2, 
12-4, and others), the Ari thmeti cExcepti on, the IndexOutOfBounds 
Excepti on, the infamous Nul 1 Poi nterExcepti on, and many others. When 
you write Java code, much of your code is susceptible to these exceptions, but 
enclosing the code in t ry clauses (or passing the buck with throws clauses) is 
completely optional. 

The Java API also has its share of checked exceptions. The computer can 
readily detect exceptions of this kind. So Java insists that, for an exception of 
this kind, any potential exception-throwing statement is acknowledged with 
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either a try statement or a throws clause. Java's checked exceptions include 
the InterruptedExcepti on (Listings 12-9 and 12-10), the IOExcepti on, the 
pti on, and a gang of other interesting exceptions. 



'pBodfe 

Finishing the Job v)ith a finally Clause 



Once upon a time, I was a young fellow, living with my parents in Philadelphia, 
just starting to drive a car. I was heading toward a friend's house and thinking 
about who knows what when another car came from nowhere and bashed my 
car's passenger door. This kind of thing is called a RunARedLightException. 

Anyway, both cars were still drivable, and we were right in the middle of a 
busy intersection. To avoid causing a traffic jam, we both pulled over to the 
nearest curb. I fumbled for my driver's license (which had a very young pic- 
ture of me on it), and opened the door to get out of my car. 

And that's when the second accident happened. As I was getting out of my 
car, a city bus was coming by. The bus hit me and rolled me against my car a 
few times. This kind of thing is called a DealWithLawyersException. 

The truth is that everything came out just fine. I was bruised but not battered. 
My parents paid for the damage to the car, so I never suffered any financial 
consequences. (I managed to pass on the financial burden by putting the 

RunARedLightException into my throws clause.) 

This incident helps to explain why I think the way I do about exception han- 
dling. In particular, I wonder, "What happens if, while the computer is recover- 
ing from one exception, a second exception is thrown?" After all, the statements 
inside a catch clause aren't immune to calamities. 



Well, the answer to this question is anything but simple. For starters, you 
can put a try statement inside a catch clause. This protects you against 
unexpected, potentially embarrassing incidents that can crop up during the 
execution of the catch clause. But when you start worrying about cascading 
exceptions, you open up a very slimy can of worms. The number of scenarios 
is large, and things can become complicated very quickly. 

One not-too-complicated thing that you can do is to create a f i n a 1 1 y clause. 
Like a c a t c h clause, a f i n a 1 1 y clause comes after a t ry clause. The big dif- 
ference is that the statements in a f i na 1 1 y clause are executed whether or 
not an exception is thrown. The idea is, "No matter what happens, good or 
bad, execute the statements inside this finally clause." Listing 12-11 has an 
example. 
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Listing 12-11: Jumping Around 
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ipRP-Li static ja va . 1 ang . System . out ; 
emoFinally { 



public static void main(String args[]) I 
try { 

doSomethi ng( ) ; 
) catch (Exception e) { 

out . pri ntl n ( " Excepti on caught in main."); 

) 

) 

static void doSomethi ng( ) { 

try { 

out . pri ntl n ( 0 / 0); 
) catch (Exception e) { 

out . pri ntl n (" Excepti on caught in doSomethi ng ." ) 

out.println(0 / 0); 
} finally { 

out . pri ntl n( " I ' 1 1 get printed."); 

} 



out . pri ntl n ( " I won't get printed.") 



Normally, when I think about a try statement, I think about the computer 
recovering from an unpleasant situation. The recovery takes place inside a 
catch clause, and then the computer marches on to whatever statements 
come after the try statement. Well, if something goes wrong during execu- 
tion of a catch clause, this picture can start looking different. 

Listing 12-11 gets a workout in Figure 12-14. First, the mai n method calls 
doSomethi ng. Then, the stupid doSomethi ng method goes out of its way 
to cause trouble. The doSomethi ng method divides 0 by 0, which is illegal 
and undoable in anyone's programming language. This foolish action by the 
doSomethi ng method throws an Arithmetic Except ion, which is caught by 
the try statement's one and only catch clause. 



Figure 12-14: 

Running the 
code from 
Listing 
12-11. 



General Output 

Conf igurat ion 

Except ion caught in doSome thing . 
I'll get printed. 
Exception caught in main. 

Process completed. 
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Inside the catch clause, that lowlife doSomethi ng method divides 0 by 0 again. 
This time, the statement that does the division isn't inside a protective try 
hat's okay, because an Ari thmeti cExcepti on isn't checked. (It's 
se Runti meExcepti on subclasses. It's an exception that doesn't 
have to be acknowledged in a try or a throws clause. For details, see the 
previous section.) 



Well, checked or not, the throwing of another Ari thmeti cExcepti on causes 
control to jump out of the doSomethi ng method. But, before leaving the 
doSomethi ng method, the computer executes the try statement's last will 
and testament — namely, the statements inside the finally clause. That's 
why, in Figure 12-14, you see the words I ' 1 1 get printed. 

Interestingly enough, you don't see the words I won't get printed in 
Figure 12-14. Because the catch clause's execution throws its own uncaught 
exception, the computer never makes it down past the t ry-c a t c h-f i n a 1 1 y 
statement. 

So, the computer goes back to where it left off in the main method. Back in 
the mai n method, word of the doSomethi ng method's Ari thmeti cExcepti on 
mishaps causes execution to jump into a catch clause. The computer prints 
Exception caught in ma i n, and then this terrible nightmare of a run is 
finished. 
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. In this part . . . 

\J ou're near the end of the book, and the time has 

come to sum it all up. This part of the book is your 
slam-bam, two-thousand-words-or-less resource for Java. 
What? You didn't read every word in the chapters before 
this one? That's okay You can pick up a lot of useful 
information in this Part of Tens. 
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pBo|en^, to Avoid Mistakes 



In This Chapter 

Checking your capitalization and value comparisons 
Watching out for fall-through 

Putting methods, listeners, and constructors where they belong 
Using static and nonstatic references 
Avoiding other heinous errors 



I d< 



a* 

" he only people who never make mistakes are the people who never 
do anything at all." One of my college professors said that. I don't 
remember the professor's name, so I can't give him proper credit. I guess 
that's my mistake. 



Putting Capital Letters 
Where lhei} Belong 



Java is a case-sensitive language, so you really have to mind your Ps and Qs — 
along with every other letter of the alphabet. Here are some things to keep in 
mind as you create Java programs: 



V Java's keywords are all completely lowercase. For instance, in a Java i f 
statement, the word if can't be If or IF. 

When you use names from the Java API (Application Programming Inter- 
face), the case of the names has to match what appears in the API. 

f* You also need to make sure that the names you make up yourself are 
capitalized the same way throughout your entire program. If you declare 
a myAccount variable, you can't refer to it as MyAccount, myaccount, or 
My account. If you capitalize the variable name two different ways, Java 
thinks you're referring to two completely different variables. 



For more info on Java's case-sensitivity, see Chapter 3. 



308 Part V: The Part of Tens 



Breaking Out of a switch Statement 

I J | Vj I 1 \J VJy'l^^^i't break out of a swi tch statement, you get fall-through. For instance, 

if the value of v e r s e is 3 , the following code prints all three lines — Last 
refrain, He's a pain, and Has no brain. 

switch (verse) { 
case 3: 

out . pri nt( " Last refrain, "); 
out. printlnC last refrain,"); 

case 2: 

out . pri nt( "He ' s a pain, "); 
out . pri ntl n ( " he ' s a pain,"); 
case 1: 

out . pri nt( "Has no brain, "); 
out . pri ntl n (" has no brain,"); 

) 

For the full story, see Chapter 5. 

Comparing Values With 
a Double Equal Sign 

When you compare two values with one another, you use a double equal sign. 
The line 

if ( i nputNumber == randomNumber ) 
is correct, but the line 

if ( i nputNumber = randomNumber) 
is not correct. For a full report, see Chapter 5. 

Adding Components to a GUI 

Here's a constructor for a Java frame: 

public Simpl eFrame( ) { 

JButton button = new JButton ( "Thank you..."); 
setTi tl e ("... Steven Hayes and Virginia Sanders"); 

setLayout(new Fl owLayout( ) ) ; 
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add(button) ; 

button. addActionl_istener(th is); 
g»tSize(300, 100); 
S^tVisible(true) ; 



Whatever you do, don't forget the call to the add method. Without this call, you 
go to all the work of creating a button, but the button doesn't show up on 
your frame. For an introduction to such issues, see Chapter 9. 



Adding Listeners to Handle Events 

Look again at the previous section's code to construct aSimpleFrame.If you 
forget the call to addActi onLi stener, nothing happens when you click the 
button. Clicking the button a second time and clicking it harder don't help. 
For the rundown on listeners, see Chapter 16, which is on the CD-ROM. 



defining the Required Constructors 

When you define a constructor with parameters, as in 

public Temperature(doubl e number) 

then the computer no longer creates a default parameterless constructor for 
you. In other words, you can no longer call 

Temperature roomTemp = new Temperature( ) ; 

unless you explicitly define your own parameterless Temperature constructor. 
For all the gory details on constructors, see Chapter 9. 



Fixing Non-Static References 

If you try to compile the following code, you get an error message: 

class WillNotWork ( 

String greeting = "Hello"; 

public static void main(String args[]) { 
System.out.println(greeting); 

) 

) 
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You get an error message because main is static, but greeti ng isn't static. 
For the complete guide to finding and fixing this problem, see Chapter 10. 

DropBooks 

Staying utithin Bounds in an Array 

When you declare an array with ten components, the components have indices 
0 through 9. In other words, if you declare 

int guests[] = new int[10]; 

then you can refer totheguests array's components by writing g u e s t s [ 0 ] , 
guests [1], and so on, all the way up to guests[9]. You can't write 
guests [10], because the guests array has no component with index 10. 

For the latest gossip on arrays, see Chapter 11. 



Anticipating Mull Pointers 



This book's examples aren't prone to throwing theNullPointerException, 
but in real-life Java programming, you see that exception all the time. A 
Nul 1 Poi nterExcepti on comes about when you call a method that's sup- 
posed to return an object, but instead the method returns nothing. Here's a 
cheap example: 

import static Java . 1 ang . System. out ; 
import j ava . i o . Fi 1 e ; 

class ListMyFiles { 

public static void main(String args[]) { 
File myFile = new Fi 1 e( "Wwindows" ) ; 

String dir[] = myFile. 1 ist( ) ; 

for (String fileName : dir) I 
out . pri ntl n ( f i 1 eName ) ; 



This program displays a list of all the files in the wi ndows directory. (For clar- 
ification on the use of the double backslash in " \ \ w i n d o w s " , see Chapter 8.) 
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But what happens if you change Wwindows to something else — something 
that doesn't represent the name of a directory? 



File = new File( "&*%$! !"); 



Then the new File call returns null (a special Java word meaning "nothing") 
so the variable my Fi 1 e has nothing in it. Later in the code, the variable d i r 
refers to nothing, and the attempt to loop through all the di r values fails mis- 
erably. You get a big NullPointerException, and the program comes crash- 
ing down around you. 

To avoid this kind of calamity, check Java's API documentation. If you're 
calling a method that can return null, add exception-handling code to your 
program. 

For the story on handling exceptions, see Chapter 12. For some advice on 
reading the API documentation, see Chapter 3 and this book's Web site. 



Helping Jatfa Find its Files 

You're compiling Java code, minding your own business, when the computer 
gives you a NoCl assDef FoundError. All kinds of things can be going wrong, 
but chances are that the computer can't find a particular Java file. To fix this, 
you must align all the planets correctly. 

i>* Your project directory has to contain all the Java files whose names are 
used in your code. 

If you use named packages, your project directory has to have appropri- 
ately named subdirectories. 

Your CLASSPATH must be set properly. 

For specific guidelines, see Chapter 15 (on the CD-ROM) and this book's 
Web site. 
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Chapter 14 

enSets of Web Resources 
for Java 



In This Chapter 

Finding resources from Sun Microsystems 
Getting sample code 
Reading the latest Java news 
Starting out — help for Java beginners 

Moving up — jobs, certification, and more for experienced programmers 



J\]o wonder the Web is so popular. It's both useful and fun. This chapter 
# V has ten bundles of resources. Each bundle has Web sites for you to 
visit. Each Web site has resources to help you use Java more effectively. And 
as far as I know, none of these sites uses adware, pop-ups, or other grotesque 
things. 



Sun's official Web site for Java is j ava . sun . com. This site has all the latest 
development kits, and many of them are free. In addition, Sun has two special- 
purpose Java Web sites. Consumers of Java technology should visit www .Java, 
com. Programmers and developers interested in sharing Java technology can 
go to www . Java . net. 

And be sure to visit www .jcp.org, home of the Java Community Process. At 
this site, you can read the latest proposals for improving Java. Who knows? 
You may even want to contribute. 
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Finding Metis, Retfierts, 
pRcbQMpte Code 

The Web has plenty of sites devoted exclusively to Java. Many of these sites 
feature reviews, links to other sites, and best of all, oodles of sample Java code. 
Some also offer free mailing lists that keep you informed of the latest Java 
developments. Here's a brief list of such sites: 

The JavaRanch: www .javaranch.com 
Gamelan: www .developer, com/ Java 

V The Giant Java Tree: www .gjt.org 

V The Java Boutique: j avabouti que . i internet . com 
Freewarejava.com: www . f reewa re Java .com 

V JavaToys: www . ni kos . com/ javatoys 
JavaShareware.com: www .javashareware.com 



Improving \lour Code With Tutorials 

To find out more about Java, you can visit Sun's online training pages. The 
Web address is java . sun . com/devel oper/onl i neTrai ni ng. Some other 
nice tutorials are available at the following Web sites: 

Richard Baldwin's Web site: www . di ckba 1 dwi n . com 

IBM developerWorks: www-106 . i bm .com/devel operworks/trai ni ng 
V ProgrammingTutorials.com: www . programmi ngtutori al s . com 



Finding Help on Newsgroups 

Have a roadblock that you just can't get past? Try posting your question on 
an Internet newsgroup. Almost always, some friendly expert posts just the 
right reply. 
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With or without Java, you should definitely start exploring newsgroups. You 
can find thousands of newsgroups — groups on just about every conceivable 
s, there are more newsgroups than For Dummies titles!) To get started 
groups, visit groups . googl e . com. For postings specific to Java, look 
for the groups whose names begin with comp.lang.java. For a novice, the fol- 
lowing three groups are probably the most useful: 

V com p. 1 ang . Java. programmer 

comp.lang.java.help 
i>* comp .lang.java.gui 



Checking the FAQs for Useful Info 

Has the acronym FAQ made it to the Oxford English Dictionary yet? Everybody 
seems to be using FAQ as an ordinary English word. In case you don't already 
know, FAQ stands for frequently asked questions. In reality, an FAQ should be 
called ATQTWTOSPOTN. This acronym stands for Answers to Questions That 
We're Tired of Seeing Posted on This Newsgroup. 

You can find several FAQs at the official Sun Web site. You can also check out 
the FAQs for the comp.lang.java newsgroups that I discuss in the previous 
section. To read this wealth of information, go to www .afu.com/javafaq. html . 



Opinions and Advocacy 

Java isn't just techie stuff. The field has issues and opinions of all shapes and 
sizes. To find out more about them, visit www .javalobby.org. After you've 
hovered for a while and have a feel for the etiquette, you can even join the 
discussion. 



Looking for Ja(/a Jobs 

Are you looking for work? Would you like to have an exciting, lucrative career 
as a Java programmer? Then try visiting a Web site that's specially designed 
for people like you. Point your Web browser to www .javajobs.comor 
java.computerwork.com. 
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Becoming Certified in Jatfa 



yt|3^i^ys, everybody is anxious to become certified. If you're one of these 
people, you can find plenty of resources about Java certification on the Web. 
Just start by visiting www .javaprepare.com and www .javaranch.com/ 
ri ng . j sp. Both of these sites link to other interesting sites, including sites 
with practice certification exams. 



This book has all the tools that you need to start using Java. When you've fin- 
ished being started, you may want to start continuing. This may involve writing 
Java servlets. 

A servlet is program that responds to a Web request. For instance, a user sit- 
ting at a computer in Ong's Hat, New Jersey, clicks a link. The link-click is sent 
to a host computer in Chicken, Alaska. Sophisticated as it is, that host com- 
puter in Chicken composes an entire Web page on the fly. The host computer 
sends the newly composed page back to the visitor's computer in Ong's Hat, 
New Jersey. 

Composing a Web page on the fly is something that you can do with a Java 
servlet. The only extra thing that you need is a cooperative host computer. 
Fortunately for cheapskates, you can use some host computers for free. For 
lists of servlet-enabled hosts, visit www .coolservlets. com /hosts, html and 
www .servlets.com/isps/servlet/ISPVi ewAl 1 . 



It's true — these two sites aren't devoted exclusively to Java. However, no 
geek-worthy list of resources would be complete without Slashdot and 
SourceForge. 

Slashdot's slogan, "News for nerds, stuff that matters," says it all. At 
slashdot.org you find news, reviews, and commentary on almost anything 
related to computing. There's even a new word to describe a Web site that's 
reviewed or discussed on the Slashdot site. When a site becomes overwhelmed 
with hits from Slashdot referrals, one says that the site has been slashdotted. 



bet/eloping Sertftets 



Everyone's Fai/orite Sites 
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Although it's not quite as high-profile, sourceforge.netis the place to look 
for open source software of any kind. The SourceForge repository contains 

00 projects. At the SourceForge site, you can download software, read 
rks in process, contribute to existing projects, and even start a pro- 
ject of your own. SourceForge is a great site for programmers and developers 
at all levels of experience. 
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In this part . . . 

I\ ppendix A tells you how to use the book's CD-ROM. 
r • And, by the way, if you haven't cracked open the 
seal on the book's CD-ROM yet, please do so. (Of course, 
you should pay for the book first.) The CD-ROM has some 
wonderful things on it — all the code from the book, a 
special customized version of JCreator, some fun share- 
ware, plus a few additional chapters! 

Appendix B covers some important material on the use of 
names in Java programs. Appendix B also features some 
of my favorite figures and illustrations, so (please) spend 
a few minutes with this appendix. 



DropBooks, 
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Using the CD-ROM 



In This Appendix 

Knowing system requirements 

Installing software from the CD-ROM 

Finding this book's listings on the CD-ROM 

Playing with the toys (that is, the software) on this CD-ROM 

Troubleshooting 



^kure, you can read, read, read until your eyes bug out. But you won't get 
^^to know Java until you write and run some code. Besides, it's no fun to 
just read about programming. You've got to experiment, try things, make 
some mistakes, and discover some things on your own. 

So this book's CD-ROM has everything you need to get going interactively. 
First, read the little warning about all the legal consequences of your break- 
ing the seal on this book's disc pack. Then, throw caution to the wind and rip 
that pack open. Put the CD-ROM in the drive, and you're ready to go. 



What \lou Can Expect to Find 



This CD-ROM has four kinds of files on it: 

Files that I, the author, created: For the most part, these files contain all 
the listings in this book (Listing 3-1 in Chapter 3, for instance). Most of 
these listings are Java program files. 

The JCreator integrated development environment: A free copy of the 
software, specially customized for this book. 




on the CD-ROM 
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V Extra chapters in PDF format: When I start writing, I can't stop. Eventually, 
the folks at Wiley Publishing ran out of paper, so they put additional 



ters on the CD-ROM. 



ous pieces of freeware, shareware, and whateverware: I generally 
lapse into laziness and call all these things by the name shareware, but 
the legal department tells me that I should be more careful. 



System Requirements 



Your system requirements depend on the kind of computer that you have and 
the kind of operating system that you use. To run the Java 5.0 Software 
Development Kit on a typical Windows computer, you need at least the fol- 
lowing resources: 

A Pentium II processor. (A processor that's older and clunkier than a 
Pentium II may be okay, but I make no guarantees.) 

is Microsoft Windows (98, Me, 2000, XP, or Server 2003). 

i>* Enough RAM, whatever that means. The official word from Sun 

Microsystems isn't specific about this, but I suspect that 128MB is the 
bare minimum. 

You'd better have a CD-ROM drive. Otherwise, you'll have difficulty grab- 
bing software off this book's CD-ROM. 

For the basic tools to write and run your own Java programs, you need 
about 140MB of disk space. (If you want to store Sun's documentation, 
the source files, demos, and other goodies, you need over 400MB.) 

If your computer doesn't match up to most of these requirements, you may 
have problems getting your Java programs to run. But remember, "may have 
problems" doesn't mean that Java won't work. For the latest and greatest 
information on Windows configurations, visit java.sun.eom/j2se/l.5.0/ 
i nstal 1 wi ndows . html . (And be prepared to change 1 . 5 . 0 in the Web 
address to 1 . 5 .someth ing-el se. These version numbers are moving targets.) 

If you're not a fan of Microsoft Windows, visit java.sun.eom/j2se/l.5.0/ 
system conf i gurati ons . html for a list of supported system configura- 
tions. (Once again, be prepared to change 1 . 5 . 0 to 1 . 5 . somethi ng-el se.) 

\\V ^ Additional Java compiler versions (versions for computers not officially sup- 
"~ " ported by the folks at Sun Microsystems) appear frequently on the Web. So if 
your computer runs Macintosh OS, OpenVMS, or FLKOS (Fred's Little Known 
Operating System), search the Web for the compiler that you need. Who 
knows? You may just find it. 
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If you find nothing at one of these 1.5.0 Web addresses, change the number 
in the address to 1 .5 . somethi ng-el se. Maybe they're up to Java version 
/"S'E^C^ 2 or even 1 . 5 . 1. Of course, if you can't find the correct Web 
^opSg^and you don't enjoy guessing games, you have another alternative. 
Pay a visit to this book's Web site. At that site, I (try to) keep a fairly up-to- 
date list of useful Java links. 

Finally, if you need more information on basic hardware and software issues, 
check out these books published by Wiley Publishing, Inc.: PCs For Dummies, 
by Dan Gookin; Macs For Dummies, by David Pogue; Windows 2000 
Professional For Dummies, by Andy Rathbone and Sharon Crawford; and 
Windows 98 For Dummies, Microsoft Windows ME Millennium Edition For 
Dummies, and Windows XP For Dummies, all by Andy Rathbone. 



Usinq the CD urith Microsoft Windows 

To install items from the CD to your hard drive (with the Autorun feature 
enabled), follow these steps: 

1. Insert the CD into your computer's CD-ROM drive. 

A window appears with the following options: HTML Interface, 
Browse CD, and Exit. 

2. Select one of the options, as follows: 

• HTML Interface: Click this button to view the contents of the CD in 
standard For Dummies presentation. It looks like a Web page. Here 
you can also find a list of useful Web links from the book. 

• Browse CD: Click this button to skip the fancy presentation and 
simply view the CD contents from the directory structure. This 
means that you see just a list of folders — plain and simple. 

• Exit: Well, what can I say? Click this button to quit. 

If you don't have the Autorun feature enabled, or if the Autorun window 
doesn't appear, follow these steps to access the CD: 

1. Insert the CD into your computer's CD-ROM drive. 

2. Click the Start button and choose Run from the menu. 

3. In the dialog box that appears, type d:\start.htm. 

Replace d with the proper drive letter for your CD-ROM if it uses a differ- 
ent letter. (If you don't know the letter, double-click the My Computer 
icon on your desktop and see what letter is listed for your CD-ROM drive.) 

Your browser opens, and the license agreement appears. If you don't 
have a browser, Microsoft Internet Explorer is included on the CD. 
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4. Read through the license agreement, nod your head, and click the 
Agree button if you want to use the CD. 

you click Agree, you're taken to the Main menu, where you can 
se through the contents of the CD. 



5. To navigate within the interface, click a topic of interest to take you to 
an explanation of the files on the CD and how to use or install them. 

6. To install software from the CD, simply click the software name. 

You see two options: to run or open the file from the current location or 
to save the file to your hard drive. Choose to run or open the file from its 
current location, and the installation procedure continues. When you 
finish using the interface, close your browser as usual. 

Note: I've included an "easy install" in these HTML pages. If your browser 
supports installations from within it, go ahead and click the links of the pro- 
gram names you see. You see two options: Run the File from the Current 
Location and Save the File to Your Hard Drive. Select the Run the File from 
the Current Location option and the installation procedure continues. 
A Security Warning dialog box appears. Click Yes to continue the installation. 



Uslnq the CO vOith Mac OS 



To install items from the CD to your hard drive, follow these steps: 

1. Insert the CD into your computer's CD-ROM drive. 

In a moment, an icon representing the CD that you just inserted appears 
on your Mac desktop. Chances are that the icon looks like a CD-ROM. 

2. Double-click the CD icon to show the CD's contents. 

3. Double-click start. htm to open your browser and display the license 
agreement. 

If your browser doesn't open automatically, open it as you normally 
would by choosing FileOOpen File (in Internet Explorer) or 
FileOOpenOLocation in Netscape and select Java 2 For Dummies. The 
license agreement appears. 

4. Read through the license agreement, nod your head, and click the 
Accept button if you want to use the CD. 

After you click Accept, you're taken to the Main menu. This is where you 
can browse through the contents of the CD. 

5. To navigate within the interface, click any topic of interest, and you're 
taken you to an explanation of the files on the CD and how to use or 
install them. 

6. To install software from the CD, simply click the software name. 
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Rimninq the Jatfa Code 
D r 0 pB#© R&his Book 

The CD-ROM has all the code from the listings in this book. It also has some 
helper files (data files and other things) that you need to make the most of all 
the listings. 

If you install JCreator from the CD-ROM, all the code from the book's listings 
gets installed automatically. The code is installed in JCreator's My Projects 
directory on your computer's hard drive. For details, see Chapter 2. 




If you don't install JCreator from the CD-ROM, you can still copy this book's 
code to your computer's hard drive. Just navigate to the folder named Author 
on the CD-ROM. Copy everything in that Author folder to your hard drive. 



I've tried to organize the book's listings in a simple, yet sensible way. I thought 
a long time and came up with a grand plan. The plan is pretty intuitive, so 
you can either read about the plan or just follow your nose. Personally I like 
noses, but you may like the security of having neatly printed rules. If you 
want rules, I present them right here: 

V If you use JCreator, all the code is in subdirectories of the My Projects 
directory (See Chapter 2.) 

V Each example has its own subdirectory, and each subdirectory consti- 
tutes a single project. For instance, the code from Listing 3-1 is in its own 
little directory named Listing0301. The tree in JCreator's File View 
pane has a branch labeled Listing0301. 

*** In some cases, several of the book's listings combine to make one big 
example. In such cases, that example's subdirectory has a big combined 
name. For instance, in Chapter 7, you get the first full example when you 
compile and run Listings 7-1 and 7-2. So the directory for this example is 
named Listings070102. The tree in JCreator's File View pane has a 
branch labeled Listings0701-02. 

v 0 As a rule of thumb, when a listing's code begins with class SomeName, 
the code is in a file called SomeName . java. 

Examples are grouped by chapter, and each chapter has its own 
JCreator workspace. 

For instance, JCreator's MyProjects directory has subdirectories 
named Li sti ng0501, Li sti ng0502, Li sti ng0601, and so on. The 
MyProjects directory also has files named Chapter05.jcw, 
Chapter06 .jew, and so on. 

If you choose FileOOpen Workspace, and select Chapter05.jcw (or just 
plain Chapter05), you open the Chapter 5 workspace. After doing this, 
you don't see Li sti ng0601 in JCreator's File View pane. You see only the 
projects named Li sti ng0501, Li sti ng0502, Li sti ng0503, and so on. 
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Freeware, Shareware, and 
Drop£kdak® Ware 

The following sections provide a summary of the software and other goodies 
that you can find on the CD. If you need help with installing the items 
provided on the CD, refer to the installation instructions in the preceding 
section. 

Shareware programs are fully functional, free, trial versions of copyrighted 
programs. If you like particular programs, register with their authors for a 
nominal fee and receive licenses, enhanced versions, and technical support. 
Freeware programs are free, copyrighted games, applications, and utilities. 
You can copy them to as many computers as you like — for free — but they 
offer no technical support. GNU software is governed by its own license, 
which is included inside the folder of the GNU software. The distribution of 
GNU software is not restricted. See the GNU license at the root of the CD for 
more details. Trial, demo, or evaluation versions of software are usually lim- 
ited either by time or functionality (such as not letting you save a project 
after you create it). 




JCreator 

Special edition 

For Windows. When I started working on this book's second edition, I went 
looking for the right Java development environment. I needed something that 
satisfies all your needs: 

f Easy to use: You want to use Java. You don't want to memorize thousands 
of ways to point and click. 

Powerful: You want a scalable tool. As you write bigger and better 
programs, you want an environment that can support your growing, 
complex requirements. 

Efficient: Memory hogs and CPU hogs need not apply. 

f Inexpensive: Hey, how about free? 

Versatile: In May of 2004, very few development environments sup- 
ported the enhancements in the upcoming Java version 5.0. 1 needed 
a tool that supports all the enhancements, without concession or 
compromise. 

I found all these qualities in only one product: JCreator from Xinox Software. 
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As if this list of demands wasn't enough, I needed a company that could work 
with me to customize its tool. Based on the book's examples, I had certain 
,ed needs. I wanted to change this default here and change that 
ere. I wanted to install my book's code along with the development 
environment. Once again, the people at Xinox Software came through for me. 



JCreator is a wonderful product. I hope that you enjoy using it. 

For more information and a free trial of JCreator PRO, visit 

www . j creator .com. 



Adobe Acrobat Reader 

Commercial version 

For Windows and Mac. Talk about added value! This book has several extra 
chapters on its CD-ROM. To view these chapters, you need a program called 
Adobe Acrobat Reader. That's no problem, because a free copy of Reader is 
on the CD-ROM. 

For more information, visit www .adobe .com/acrobat. 

If you're on the road, and you need some light reading, just pull into a nearby 
cybercafe. You can find the extra chapters on this book's Web site. 

Jindent 

Trial version 

Platform independent. When it comes to writing code, beauty is more than 
skin deep. An ugly program is hard to read. If anything goes wrong, no one, 
not even the program's author, can wade through lines and lines of cryptic, 
poorly formatted classes and methods. 

To make code look good, you can follow some clear, uniform style guidelines. 
Always indent by a certain number of spaces, always arrange curly braces a 
certain way, always do this, never do that. You can memorize lots of rules, or 
you can have software do it for you. 

So write code any way that you want. Then hand your code over to Jindent. 
The Jindent program beautifies your code, making it easier to read, easier to 
understand, and (yes!) cheaper to maintain. 

For more information, visit www . j i ndent .com. 
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NetCaptor 

Drop Books™ 

For Windows. Talk about cool software! When I use someone else's computer 
and have to surf without NetCaptor, I feel terribly inconvenienced. NetCaptor 
uses tabs to keep track of several open Web pages. These tabs replace the 
need to open several browser windows. So when I visit a search engine, I keep 
the results page open while I investigate some of the page's entries. When 
I do Java development, I keep the API documentation open while I visit one or 
more of my own documents. Without NetCaptor, I can open several browser 
windows. However, the interface isn't as seamless, and the stress on my 
computer's RAM and CPU is greater. 

For more information, visit www . netcaptor .com. 



WinOne 

Evaluation 

For Windows. If you use Windows, and you're a real geek, you know how 
clumsy MS-DOS can be. The years I've wasted retyping commands is dwarfed 
only by the time that I've spent drilling for items in deeply-nested menus and 
Explorer trees. To make your life simpler, try WinOne. The WinOne shell is 
like the built-in Windows command prompt. But WinOne has multicolored 
text, smart filename completion, a scroll bar, command grouping, smart 
delete, macros, command history, extended batch commands, and (best of 
all) delightfully easy access to directories. 

For more information on WinOne, visit www . wi none . com . ail. 



And If \lou Run into Any Trouble . . . 

I tried my best to find shareware programs that work on most computers 
with the minimum system requirements. Alas, your computer may differ, and 
some programs may not work properly for some reason. 

If you have problems with the shareware on this CD-ROM, the two likeliest 
problems are that you don't have enough memory (RAM) or that you have 
other programs running that are affecting installation or running of a pro- 
gram. If you get an error message such as Not enough memory or Setup 
cannot continue, try one or more of the following suggestions and then try 
using the software again: 
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V Turn off any antivirus software running on your computer. Installation 
programs sometimes mimic virus activity and may make your computer 
rrectly believe that a virus is infecting it. 



e all running programs. The more programs that you have running, 
the less memory is available to other programs. Installation programs 
typically update files and programs. So if you keep other programs run- 
ning, installation may not work properly. 

Have your local computer store add more RAM to your computer. This 
is, admittedly, a drastic and somewhat expensive step. However, adding 
more memory can really help the speed of your computer and allow 
more programs to run at the same time. 



If you still have trouble installing the items from the CD, please call the 
Wiley Publishing, Inc. Customer Service phone number at 800-762-2974 
(outside the U.S.: 317-572-3993) or send an e-mail to the address of your 
choice: J a va2ForDummi es@BurdBrai n . com or techsupdum@wi 1 ey . com. 
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public and private 

In This Appendix 

What the words public and private mean 

What the word protected means 

What it means when you use none of these words 



f 

■ n Java, the words public and private are called access modifiers. In this 
s-fi appendix, you get a brief overview of the way that access modifiers work. 
For more details, see Chapter 15 on the CD-ROM. 

Members Versus Classes 



Here's a fake piece of Java code: 



class MyClass { 




int myVariable; 


//an instance variable 




// (a member) 


void myMethod( ) { 


//a method (another member) 


int myOtherVari abl e ; 


//a method-local variable 


) 

) 


// (not a member) 



There are two kinds of variables — instance variables and method-local 
variables. This appendix isn't about method-local variables. It's about meth- 
ods and instance variables. Both methods and instance variables are called 
members of a class. 



DropBooJss 



33 2 P art Appendixes 



ior memD 

DropBoa&S 

deals wit! 



In Java, the word public has two slightly different meanings — one meaning 
for members and another meaning for classes. Most of this appendix deals 
meaning of public (and of other such words) for members. The last 
is appendix (appropriately titled "Access Modifiers for Classes") 
deals with the meaning of public for classes. 



Access Modifiers far Members 

Can you use a certain member name in a particular place in your code? To 
answer the question, you check to see whether that place is inside or outside 
of the member's class: 

i>* If the member is private, only code that's inside the member's class can 
refer directly to that member's name. 

class SomeClass { 

private int myVariable = 10; 

} 



class SomeOtherCl ass { 

public static void mai n ( Stri ng args[]) ( 
SomeClass someObject = new SomeClassO; 

//This doesn't work: 

System . out . pri ntl n (someObject .my Vari abl e) ; 

) 

} 

If the member is public, any code can refer directly to that member's 
name. 

class SomeClass { 

public int myVariable = 10; 

} 



class SomeOtherCl ass { 

public static void main(String args[]) I 
SomeClass someObject = new SomeClassO; 

//This works: 

System . out . pri ntl n (someObject .my Vari abl e) ; 



Figures B-l through B-3 illustrate the ideas in a slightly different way. 
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class2 

extends classl 



class3 

extends class2 



classA 



classB 

extends classA 



classC 

extends classB 



classX 



classY 

extends classX 



classZ 

extends classY 




class2 

extends classl 



class3 

extends class2 



classA 



classB 

extends classA 

public variable 



classC 

extends classB 





classZ 

extends classY 
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Figure B-3: 

The range 
of code 
in which 
a private 
variable or 
method can 
be used 
(shaded). 



class2 

extends classl 



class3 

extends class2 



classA 



classB 

extends classA 

private variable 



classC 

extends classB 



classX 



classY 

extends classX 



classZ 

extends classY 



Default access 



No doubt you've seen variables and methods with no access modifiers in 
their declarations. A method or variable of this kind is said to have default 
access. In Java, the default access for a member of a class is package-wide 
access. A member declared without the word public, private, or protected in 
front of it is accessible in the package in which its class resides. Figures B-4 
and B-5 illustrate the point. 



Protected access 

Yet another access modifier isn't used in any example before this appendix. 
(At least, I don't remember using it in any earlier examples.) It's the protected 
access modifier. A member that's protected is slightly less hidden than one 
that has default access. 
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Figure B-4: 

Packages 
cut across 
subclass 
hierarchies. 
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class2 

extends classl 



class3 
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classA 



classB 

extends classA 



classC 

extends classB 





classZ 

extends classY 



Another package 



Yet another package 



Figure B-5: 

The range 
of code 
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a default 
variable or 
method can 
be used 
(shaded). 
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Legend: 
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Another package 



Yet another package 
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If a member has default access, code in a different package cannot refer directly 
to that member's name. The following example illustrates this scenario: 



package com. burd brain. somepackage ; 

public class SomeClass { 

static int myVariable = 10; 



And in another file: 



package com.burdbrain . someot her package ; 


import com.burdbrain. somepackage.*; 






class SomeOtherCl ass extends SomeCl; 


JSS ( 




public static void main(String < 


args[]) { 




//This doesn't work: 

System.out.println(myVariab' 

) 

) 


le); 




If a member is protected, code in a subclass can refer directly to that member's 
name, even if that subclass belongs to a different package. The following exam- 
ple illustrates this particular scenario: 


In one file: 






package com.burdbrain. somepackage ; 






public class SomeClass { 

protected static int myVariable 

) 


= 10; 



And in another file: 
package com. burd bra in . someotherpackage ; 
import com.burdbrain .somepackage.*; 
class SomeOtherCl ass extends SomeClass { 

public static void main(String args[]) I 
//This works: 

Sy st em. out. println( my Variable); 

) 
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aeiauit ac 

DropBodte 

Suddenly, 



Looking at this code, you see that you start with an instance variable that has 
default access (a variable without the word public, private, or protected in its 
pn). That variable can be accessed only inside the package in which 
ow add the word protected to the front of the variable's declaration. 
Suddenly, classes outside that variable's package have some access to the 
variable. A subclass (of the class in which the variable is declared) can 
now reference the variable. You can also reference the variable from a sub- 
subclass, a sub-sub-subclass, and so on. Any descendent class will do. 



Compare Figures B-5 and B-6. Notice the extra bit of shading in Figure B-6? 
A subclass can access a protected member of a class, even if that subclass 
belongs to some other package. 




The real story about protected access is one step more complicated than the 
story that I describe in this section. The Java Language Specification mentions 
a hair-splitting point about code being responsible for an object's implementa- 
tion. When you're first figuring out how to program in Java, don't worry about 
this point. Wait until you've written many Java programs. Then, when you 
stumble upon a van' abl e has protected access error message, you can 
start worrying. Better yet, skip the worrying and take a careful look at the 
protected access section in the Java Language Specification. 



Figure B-6: 

The range 
of code 
in which a 
protected 
variable or 
method can 
be used 
(shaded). 



class! 



class2 

extends classl 




classA 



classB 

extends classA 

protected 
variable 



classC 

extends classB 





classZ 

extends classY 



Legend: 



A package 



Another package 



Yet another package 
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DropBooks. 



n be either public or non-public. If you see something like 

public class SomeClass 

then you're looking at the declaration of a public class. But, if you see plain 
old 

class SomeClass 
then the class that's being declared isn't public. 

If a class is public, you can refer to the class from anywhere in your code. The 
following example illustrates the point: 

In one file: 

package com.burdbrain. somepackage ; 
public class SomeClass { 

And in another file: 
package com.burdbrain . someot her package ; 
import com.burdbrain .somepackage.*; 

//You CAN extend SomeClass: 

class SomeOtherCl ass extends SomeClass { 

public static void main(String args[]) ( 
//This works too: 

SomeClass someObject = new SomeClassO; 

) 

) 

If a class isn't public, you can refer to the class only from code within the 
class's package. The following code makes that crystal clear: 

In one file: 

package com.burdbrain. somepackage ; 

class SomeClass I 
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And in another file: 

e com.burdbrain . someot her package ; 
ilnpTiTx com.burdbrain.somepackage.*; 

//You can't extend SomeClass: 

class SomeOtherCl ass extends SomeClass { 

public static void main(String args[]) I 

//This doesn't work either: 

SomeClass someObject = new SomeClass(); 
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as multiplication operator, 90 

for traditional comments (/* and */), 59 
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in escape sequences, 255 

in path names (\\), 181 
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for blocks, 105 

indentation versus, 106 

using in programs, 55-57 
. (dot) 

ending file names, 176 

equal s method and, 110 

object calling own method and, 210 
= (equal sign) in i f statement conditions 

(==), 104-105, 308 
- (minus sign) as decrement operator (- -), 

92, 94, 95 
( ) (parentheses) 

equal s method and, 110 

for i f statement conditions, 104 

in method headers, 151, 155-156 
% (percent sign) 

in format string for pri ntf method, 
159-161, 173-174 

as remainder operator, 90-91 
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as addition operator, 89 

as concatenation operator, 89-90 

as increment operator (++), 92-96 
? (question mark) as conditional 

operator, 266 
" (quotation marks), escape sequence for 
(\"), 255 



; (semicolon) ending Java statements, 55 

' (single quotation marks) 
for cha r literals, 83 
escape sequence for (\ '), 255 

/ (slash) 
as division operator, 90, 91 
for end-of-line comments (/ /), 60 
for javadoc comments (/**), 60 
for traditional comments (/* and */), 59 

[ ] (square brackets) in array 
declarations, 251 

0 (zero) as array starting number, 251 
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Access (Microsoft), creating a database in, 

CD-50-CD-52 
access modifiers 

for classes, 338-339, CD-21-CD-23 

default access, 334 

defined, CD-2 

for members, 332-337, CD-4-CD-6 
protected access, 334-337, CD-2 
accessor methods 
as bean methods, 165 
calling, 164-165 

enforcing rules with i f statements, 167 
hiding variables using, 163-164 
public keyword for, 166 
single statement for getting and 
setting, 167 
Account class 
accessor methods in, 164, 165, 166 
di spl ay method, 150-151 
getlnterest method of, 152-154 
hiding variables, 164, 165 
simple form, 143, 144 
Acrobat Reader by Adobe (on the CD), 327 
acti onPerf ormed method of applets, 
CD-31-CD-32, CD-43 
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add method 
of A rray Li st object, 276 
|>t 1 iaal afa" I ipe object. 218 

addition operator, 89 

addPl ayerlnfo method, 226 

Adobe Acrobat Reader (on the CD), 327 

"Al's All Wet" program 

using for statement, 128-129 

using switch statement, 116-120 
and operator, 111 
anEmpl oyee variable, 173 
API (Application Programming Interface). 
See also J2SE API Documentation 

applets and, CD-40 

case-sensitive names from, 307 

complexity of, 44-45 

downloading, 44 

identifiers, 47-48 

tools in, 44 

variety of Java APIs, 46 
viewing Java API code, 45 
applets 

def aul t versus publ i c access, 

CD-39-CD-40 
defined, CD-37 
JVM and, 42 

methods in, CD-39, CD-42-CD-44 

odometer example, CD-40-CD-44 

as outdated technology, 39 

responding to events, CD-44-CD-47 

running, 39, 41-42 

running in JCreator, CD-38-CD-39 

simple example, CD-37-CD-40 
appletviewer, 42 
arithmetic operators, 90-91 
Ari thmeti cExcepti on, 302-303 
Array I ndexOutOfBounds Except ion, 

269-270, 273 
Array Li st class 

add method, 276 

generics with, 277, 278 

remove method, 276 

ShowNames class using, 275-276 

testing for the presence of more data, 277 
arrays 

Array I ndexOutOfBounds Except ion, 

269-270, 273 
assignment statements, 252 



command line arguments, 267-273 

components or elements, 250 

creating for objects, 264-265 

declarations, 251-252 

escape sequences for displaying 
values, 255 

index, 251, 252-253, 310 

initializers, 255-256 

length of, 254 

limitations of, 273-274 

in methods, 251 

modifying values, 257-261 

need for, 249-250 

of objects, 261-266 

searching, 257-261 

staying within bounds, 310 

stepping through, 256-257 

storing values in, 252-256 

two-line versus single-line declaration, 251 

values, 251 
Art Frame class, CD-12 
ArtFrame object, CD-6-CD-8, CD-11, CD-13 
ASCII Character Encoding, 83 
assignment operators, 96-97 
assignment statements 

for arrays, 252 

declarations versus, 92 

overview, 73-74 
asterisk (*) 

in import declarations, 111, 217 

for javadoc comments (/**), 60 

as multiplication operator, 90 

for traditional comments (/* and */), 59 
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backslash (\) 
escape sequence for (\\), 255 
in escape sequences, 255 
in path names (\\), 181 

backspace, escape sequence for, 255 

bean methods. See accessor methods 

birth method 
TrackPopul ati on class, 242-243 
TrackPopul ati on2 class, 243-244 
TrackPopul ati on3 class, 244-245 

blocks, 105, 133-134 

bold type in this book, 2 

bonus chapters for this book, 5-6 
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boolean type, 84-85, 102 
Borland JBuilder IDE, 30 

(t^^JfyJE), 129 

switch statements and, 119-120, 308 
Bright, Herbert (data processing 

manager), 279 
browsers. See Web browsers 
bugs. See also error messages; exception 
handling; exceptions 
history of, 279-280 
key to fixing, 281 
Burd, Barry 
e-mail address, 7, 329 
Java 2 For Dummies, 1-7 
buttons 

act ion Performed method, CD-31-CD-32 

events and event handling, CD-27-CD-28 

interfaces and, CD-28-CD-29 

this keyword and, CD-31 

threads of execution and, CD-29-CD-31 

window with a button, CD-25-CD-27 

byte type, 80, 81 

bytecode files, 40 



C language, 14 

C++ language, 14, 17 

calling constructors, 203, 214-215 

calling methods 

accessor methods, 164-165 

in applets, CD-39 

defined, 52 

of exception objects, 284 
main method and, 53 
need for, 51 

object calling own method, 210 

statements for, 54 
carriage return escape sequence, 255 
case 

Character. toLlpperCase method, 83 
Java as case-sensitive, 50, 307 
recommendations, 307 
catch clauses. See also try statements 
defined, 283 
matching, 288 
as mini-method, 284 
multiple, for one try clause, 286-293 



never thrown exceptions and, 293-294 

order of processing for, 286-287, 288-293 

parameter list, 284 
catch keyword, 282 
catching exceptions. See also catch 
clauses; exception handling 

defined, 281 

illustrated, 282 

t ry statements for, 283 
CD-ROM with this book 

bonus chapters on, 5-6 

contents, 321-322 

JCreator LE on, 31 

Listings0801-02 directory, 180 

On the CD icon, 7 

running code in this book, 325 

ShowTeamFrame class on, 232 

software on, 326-328 

system requirements, 322-323 

TeamFrame class on, 232 

technical support, 329 

troubleshooting, 328-329 

using with Mac OS, 324 

using with Microsoft Windows, 323-324 
certification, 316 
char type, 82-84 
characters. See also String type 

char type for, 82-84 

comparison operators with, 108 

reading a single character, 132 
Character.toUpperCase method, 83 
child classes. See subclasses (child classes) 
Class Wizard (JCreator), 66-67 
classes 

access modifiers for classes, 338-339, 

CD-21-CD-23 
access modifiers for members, 332-337 
adding in JCreator, 66-67 
as collections of declarations, 89 
compiling and running multiple classes, 

147-148 
created from en urn types, 206 
curly braces in, 56 
declaring variables, 144-146 
defined, 141 

defining in programs, 142-147 
defining methods in, 148-151 
describing as goal of OOP, 49, 141 
extending, 19 
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classes (continued) 
fully qualified names, 217 
is, 77-78 



d Books 

interfaces versus, C 



interfaces versus, CD-28 
members, defined, 331 
members versus, 332, CD-3 
naming, 50 

nonpublic, 338, CD-21, CD-22-CD-23 
non-static variable or method... 

message and, 234 
objects and, 17-18, 141 
overview, 17-18, 20-22 
as programs, 50 

public, 332, 338-339, CD-3, CD-21-CD-22 

as reference types, 87 

referencing packaged classes, CD-21-CD-22 

required in Java, 49-50 

in same package, CD-I 7, CD-20-CD-21 

subclasses or child classes, 19 

superclasses or parent classes, 19 
ClassNotFoundException, CD-56 
CLASSPATH definition, CD-11 
COBOL language, 14 
code 

adding in JCreator, 67 
on the CD-ROM, 325 
checking out for first time, 48-49 
commenting out, 62-63 
copying and pasting, 177-178 
curly braces in, 55-57 
defined, 12 
example, 12-13 
indenting, 56, 57, 105-106 
Java bytecode, 40 
safety versus security, 162 
viewing in JCreator, 48-49 
viewing Java API code, 45 
Web sites for sample code, 314 
collection classes 
Array Li st, 275-278 
generics with, 277, 278 
need for, 273-274 
overview, 274-275 

testing for the presence of more data, 277 
combining declarations, 80-81 
command line arguments 

checking the number of, 269-270 

JCreator setup for, 270-273 



String args[ ] in ma i n method 

and, 267 
using in Java programs, 267-269 
comments 
adding to code, 58-61 
audience for, 61 
commenting out code, 62-63 
end-of-line, 59 

for experimenting with code, 62-63 

javadoc, 60-61 

need for, 58, 61 

traditional, 59 

uncommenting code, 63 
comparison operators 

comparing objects with, 108-110 

comparing values with, 308 

overview, 107-108 

table summarizing, 106 
compiler, defined, 40 
compiling 

Java programs, 40 

JCreator projects, 37, 67 

multiple classes, 147-148 
components of arrays 

declaring number of, 251 

defined, 250 
Computer Science Advanced Placement 

exams, 15 
computers 

equipment and knowledge needed, 3 

value of, 11-12 
concatenation operator, 89-90 
conditional operator, 266 
conditions in i f statements, 103-104 
configuring 

JCreator, 31-33 

Windows (Microsoft), 322-323 
connecting to databases, CD-55-CD-56 
constructors 

assigning values to variables, 204-205 

calling, 203, 214-215 

default, 212-213, 309 

defining a frame, 215-217, 308-309 

file clobbering by, 260 

invisible call to super, 214-215 

methods versus, 202 

object creation and, 202 

parameters for identifying, 203 
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startup tasks and, 200, 215-218 
stati c keyword and, 231 
^uttflass* ^10-211, 212-215 
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throws IOExcepti on clause in, 228 
context, meaning of names and, 235-236 
conventions in this book, 1-2 
copying and pasting code, 177-178 
counters 
in for loops, 124 
i nt type for, 138 
for loops without, 129, 134-136 
Crawford, Sharon (Windows 2000 

Professional For Dummies), 323 
Create New Data Source window (Access), 

CD-50-CD-51 
CreateTable class, CD-53-CD-54 
Cross-Reference icon, 6 
curly braces ({ }) 
for blocks, 105 
indentation versus, 106 
using in programs, 55-57 
currency 
formatting, 265-266 

program for displaying local, CD-32-CD-36 
Customer Service, 329 
cutCheck method, 171-172, 173-174 



database drivers, CD-55 
databases 

connecting and disconnecting, 
CD-55-CD-56 

creating a table, CD-53-CD-54 

creating an Access database, CD-50-CD-52 

creating data, CD-53-CD-56 

retrieving data, CD-56-CD-59 

storing values in arrays, 253 

telling the system about, CD-49-CD-52 

using SQL commands, CD-54-CD-55 
decimal places 

Decimal Format class and, 223, 266 

formatting currency, 265-266 

rounding numbers for, 159-161 
Decimal Format class, 223, 266 
decision-making statements. See flow 
control 



declarations 
array, 251-252 

assignment statements versus, 92 

blocks and variable declarations, 133-134 

classes as collections of, 89 

combining, 80-81 

displ ay method header, 151 

import, 77-78, 111 

method, 52 

package, CD-8 

pri vate keyword for variables, 165 
public keyword for accessor 

methods, 166 
reference type, 87-88 
variable, 75, 133-134, 144-146 
variables declared inside versus outside 
methods, 236-241 
decrement operator (- -), 92, 94, 95 
default access, 334, CD-14-CD-17, 

CD-39-CD-40 
default constructor, 212-213, 309 
defining classes, 142-147 
deleting files, 133 

demo versions of software. See trial 
versions of software 

DemoFinal ly class, 302-303 

development of Java, 14-15, 16-17 

Diaconis, Persi (mathematician), 102 

directories 
adding to filenames, 181 
CLASSPATH for, CD-11 
configuring JCreator and, 31-33 
Fi 1 eNotFoundExcepti on and, 181 
Java home directory, 28-29, 31-32 
in Java home directory, 24 
for Java SDK, 27-28 
Javadoc, 24, 29, 32-33 
NoClassDefFoundError, 311 
package directory structure, CD-8-CD-9 

disconnecting from databases, CD-55-CD-56 

disk files. See file handling 

displ ay method for objects, 150-151 

displaying 
filename extensions, 35 
Java API code, 45 
Java code for first time, 48-49 
object-oriented programming and, 149 
text, 78 
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division operator, 90, 91 
"Do this/Do that" languages, 16-17 
dETo) r^iMthfcd, 0^6-247 
q>cJr^tlffl|<\^gy2SE API 

Documentation 
DocumentLi stener interface, 

CD-35-CD-36 
DoPayroll class, 172-173, 174 
DoPayrol lTypeF class, 197-198 
dot (.) 

ending file names, 176 

equal s method and, 110 

object calling own method and, 210 
doubl e type 

comparison operators and, 108 

method for getting, 102 

overview, 75-77, 82 
do . . .while statement 

for continuing after catching exceptions, 
294-295 

deleting program example, 131-132 
need for, 129-130 
reading a single character, 132 
downloading. See also Internet resources 
Java, 25-26 

Java Language Specification, 44 
J2SE API Documentation, 24, 26, 44 
for online versus offline installation, 26 
SDK (Software Development Kit), 24, 25-26 

Drawi ng class 
CLASSPATH and, CD-11 
default access and, CD-14 
Drawi ngWide subclass, CD-13-CD-14 
Drawi ngWi deBB subclass, CD-17 
overview, CD-7-CD-8 
protected variables, CD-18-CD-19 

drawings 
packages for, CD-7 
putting on frames, CD-6-CD-8, 
CD-ll-CD-12 

Drawi ngWi de class, CD-13-CD-14, CD-15, 
CD-18-CD-19 

Drawi ngWi deBB class, CD-17 

drawRect method, CD-40 

drawStri ng method, CD-40 

Dummies Panel class, CD-38-CD-39 



Eclipse IDE, 30 
e-mail addresses 

for the author, 7, 329 

Wiley technical support, 329 
Empl oyee class 

accessor methods, 171 

cutCheck method, 171-172 

Ful ITimeEmpI oyee subclass, 185-188, 
189-194, 212-213 

main method missing from, 172 

overview, 171-172 

PartTimeEmpl oyee subclass, 185, 188, 
191-194 
EmployeeInfo.txt file 
listing, 175 
overview, 174 
storing data in, 175-176 
end-of-file exceptions, 295-296 
English, unsuitability for programming, 12 
Engl i shSpeaki ngWorl d class, 

236, 237, 238 
Engl i shSpea ki ngWorl d2 class, 239-241 
en urn types 
classes created from, 206 
for groups, 136-137 
ScaleName, 201-202, 206-207 
scales as, 201 
val ues method for, 138 
EOFException, 295-296 
equal sign (=) in i f statement conditions 

(==), 104-105, 308 
equal s method, 109-110 
error messages. See also exception 

handling; exceptions; troubleshooting 
CD-ROM with this book and, 328-329 
getMessage method of exception objects 

and, 284 
JCreator compiler messages, 68 
NoClassDefFoundError,311 
non-static variable or method..., 

234-235 
NoSuchMethodError, 148 
variable has protected access, CD- 
21 

escape sequences, 255 
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evaluation versions of software. See trial 

versions of software 
k e||3 

|oJt4^4s^^\^:D-47 

for button-click events, CD-28 
events defined, CD-27-CD-28 
interfaces and, CD-28-CD-29 
for keyboard events, CD-32-CD-36 
listeners for, 309 

threads of execution and, CD-29-CD-31 
exception handling 
acknowledging exceptions in the code, 

297-301 
catch clause, 283 
catching exceptions, defined, 281 
checked versus unchecked exceptions 

and, 297-298, 302-303 
continuing after catching exceptions, 

294-295 

creating your own exception, 285-286 
desired exceptions for expected 

occurrences, 295-296 
for end-of-file exceptions, 295-296 
exceptions in catch clauses, 301-303 
final ly clause, 301-303 
Java mechanism, 281 
by JVM, 228 
keywords for, 281-282 
mai n method and, 227-228 
multiple catch clauses for one try 

clause, 286-293 
need for, 282 

for negative numbers, 285-286 

never thrown exceptions and, 293-294 

order of processing for catch clauses, 

286-287, 288-293 
sleep method and, 296-301 
throwing exceptions, defined, 281 
t ry clause, 283 
try statements defined, 283 
exceptions. See also exception handling 
acknowledged in the code, 297-301 
Ari thmeti cExcepti on, 302-303 
ArraylndexOutOfBoundsException, 

269-270, 273 
calling methods of exception objects, 284 
in catch clauses, 301-303 



catching, defined, 281 
checked versus unchecked, 297-298, 
302-303 

ClassNotFoundException, CD-56 
creating your own, 285-286 
database, CD-56 

desired, for expected occurrences, 

295-296 
end-of-file, 295-296 
EOFException, 295-296 
Fi 1 eNotFoundExcepti on, 180-181 
InterruptedException, 297-301 
IOExcepti on, 291-292, 301 
mai n method and, 227-228 
messages as key to fixing bugs, 281 
never thrown, 293-294 
Nul 1 Poi nter Except ion, 310-311 
NumberFormatExcepti on, 281, 282, 290 
NumberTooLargeExcepti on, 287-288, 

291, 293 

OutOfRangeException, 285-286, 288, 

290, 291, 293 
RunTi me Except ion, 303 
sleep method and, 296-301 
SQLException, 301, CD-56 
throwing, defined, 281 
throws IOExcepti on clause, 177, 179, 

227-228 

executeUpdate command (SQL), CD-54 
expressions 

assignment operators and, 97 

conditions as, 104 

defined, 85 

in for statements, 127 
extending classes, defined, 19 



fall-through with switch statements, 

119-120, 308 
FAQs (frequently asked questions), 315 
file handling 

adding directories to filenames, 181 

copying and pasting code for, 177-178 

deleting files, 133 

DoPayrol 1 class and, 174 

file clobbering by constructors, 260 



Java 2 For Dummies, 2nd Edition 




file handling (continued) 
Fi 1 eNotFoundExcepti on, 180-181 
jjala^icykclapfri^n class and, 179 
^\J\J |\c5S)s and, 133, 179 
j ava . i o . Pri ntStream class and, 260 
reading data from a file, 177-183 
storing data in a file, 175-176 
filename extensions, showing, 35 
Fi 1 eNotFoundExcepti on, 180-181 
finally clause, 30 1-303 
f i ndPaymentAmount method 
Ful ITimeEmpI oyee class, 191, 192 
overriding, 196-197 
PartTimeEmpl oyee class, 191-192 
PartTimeWithOver class, 196-197 
testing the code, 198 
FindVacancy class, 257-261 
float type, 76, 77, 82, 108 
flow control. See also i f statements; loops; 
switch statements 
break statements and, 119-120, 129, 308 
comparison operators for, 107-110, 308 
logical operators for, 111-113 
nesting if statements, 113-115 
FI owLayout class, 218 
Font class, CD-40 
fonts 
for applets, CD-40 
conventions in this book, 2 
for statement 
"Al's All Wet" example, 128-129 
basic format, 126 
break statements with, 129 
counters, 124 

cycling through groups, 134-136 

enhanced for loop, 134-138 

expressions in, 127 

initialization, 127 

other repetition using, 129 

simple example, 125-126 

stepping through an array, 256-257 

for storing values in arrays, 253-254, 256 

update, 127 

without counters, 129, 134-136 
form feed escape sequence, 255 
format methods, 266 
format strings for pri ntf method, 
159-161, 207-208 



Formatter class, 174 
formatting numbers 

currency, 265-266 

return values, 158-161 
FORTRAN language, 14, 16-17 
frames 

buttons on, CD-25-CD-32 

constructors defining, 215-217, 308-309 

defined, 89 

J Frame type, 86-88 

making visible, 218, 227 

packages for, 218, CD-7 

packing, 226, 227 

putting drawings on, CD-6-CD-8, 
CD-ll-CD-12 

sequence for setting up, 226-227 
freeware programs 

defined, 326 

NetCaptor (on the CD), 328 
frequently asked questions (FAQs), 315 
Ful ITimeEmpI oyee class 

creating, 185-188 

default constructor, 212-213 

fi ndPaymentAmount method, 191, 192 

making types match, 190-191 

methods available, 190 

payOneFTEmpl oyee method, 193 

testing the code, 197-198 

using, extended example, 192-194 

using, minimal example, 189-191 
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GameApplet class, CD-45-CD-46 
GameFrame class 

actionPerformed method, CD-31-CD-32 

GamePanel class and, CD-46-CD-47 

listing, CD-26 

results of running, CD-27 

this keyword and, CD-31 
GamePanel class 

GameFrame class and, CD-46-CD-47 

listing, CD-45 

methods not needed in, CD-46 
results of running, CD-46 
generics, 277, 278 

getCurrency Instance method, 265-266 
GetData class, CD-57-CD-59 
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GetGoing class, 236-237 
GetGoi ng2 class, 239 
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called in UseAccount class, 153- 
header, 155-156 
passing values to, 155-156 
returning values from, 156-158 
getMessage method of exception 

objects, 284 
getter methods. See accessor methods 
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Chapter 15 



anng Names among the Parts 
of a Java Program 



In This Chapter 

Hiding names from other classes 
Exposing names to other classes 
Tweaking your code to find the right middle ground 



c 



peaking of private variables and methods (and I do speak about these 
things in this chapter). . . . 



I'm eating lunch with some friends of mine at work. "They can read your 
e-mail," says one fellow. Another chimes in, "They know every single Web site 
that you visit. They know what products you buy, what you eat for dinner, 
what you wear, what you think. They even know your deepest, darkest 
secrets. Why, I wouldn't be surprised if they know when you're going to die." 

A third voice enters the fray. "It's getting to the point where you can't blow 
your nose without someone taking a record of it. I visited a Web site a few 
weeks ago, and the page wished me a Happy Birthday. How did they know it 
was me, and how did they remember that it was my birthday?" 

"Yeah," says the first guy. "I have a tag on my car that lets me sail through toll 
booths. It senses that I'm going through and puts the charge on my credit 
card automatically. So every month, I get a list from the company showing 
where I've been and when I was there. I'm amazed it doesn't say who I was 
visiting and what I did when I got there." 

I think quietly to myself. I think about saying, "That's just a bunch of baloney. 
Personally, I'd be flattered if my employer, the government, or some big com- 
pany thought so much of me that they tracked my every move. I have enough 
trouble getting people's attention when I really want it. And most agencies 
that keep logs of all my purchasing and viewing habits can't even spell my 
name right when they send me junk mail. 'Hello, this is a courtesy call for 
Larry Burg. Is Mr. Burg at home?' Spying on people is really boring. I can 
just see the headline on the front page of The Times: 'Author of Java 2 
For Dummies Wears His Undershirt Inside Out!' Big deal!" 



CO' 2 Bonus Chapter 



So I think for a few seconds, and then I say, "They're out to get us. TV 
cameras! That's the next big thing — TV cameras everywhere." 



If you've read this far into Java 2 For Dummies, 2nd Edition (or even if you're 
browsing the bookstore shelves and have opened right to this chapter), you 
probably know one thing: Object-oriented programming is big on hiding 
details. Programmers who write one piece of code shouldn't tinker with the 
details inside another programmer's code. It's not a matter of security and 
secrecy. It's a matter of modularity. When you hide details, you keep the intri- 
cacies inside one piece of code from being twisted and broken by another 
piece of code. Your code comes in nice, discrete, manageable lumps. You 
keep complexity to a minimum. You make fewer mistakes. You save money. 
You help promote world peace. 

Other chapters have plenty of examples of the use of private variables. When 
a variable is declared private, it's hidden from all outside meddling. This 
hiding enhances modularity, minimizes complexity, and so on. 

Elsewhere in the annals of Java 2 For Dummies, 2nd Edition, are examples of 
things that are declared public. Just like a public celebrity, a variable that's 
declared public is left wide open. Plenty of people probably know what kind 
of toothpaste Elvis used, and any programmer can reference a public vari- 
able, even a variable that's not named Elvis. 

In Java, the words public and private are called access modifiers. No doubt 
you've seen variables and methods without access modifiers in their declara- 
tions. A method or variable of this kind is said to have default access. Many 
examples in this book use default access without making a big fuss about it. 
That's okay in some chapters, but not in this chapter. In this chapter, I 
describe the nitty-gritty details about default access. 

And you can find out about yet another access modifier that isn't used in any 
example before this chapter. (At least, I don't remember using it in any earlier 
examples.) It's the protected access modifier. Yes, this chapter covers some 
of the slimy, grimy facts about protected access. 



Classes, Access, and Multipart Programs 



With this topic, you can become all tangled up in terminology, so you need to 
get some basics out of the way. (Most of the terminology that you need 
comes from Chapter 10, but it's worth reviewing at the start of this chapter.) 
Here's a fake piece of Java code: 




Access Modifiers 
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//an instance variable 
// (a member) 

//a method (another member) 

int myOtherVari abl e ; //a method-local variable 
} // (not a member) 

) 

The comments on the right side of the code tell the whole story. Two kinds of 
variables exist here — instance variables and method-local variables. This 
chapter isn't about method-local variables. It's about methods and instance 
variables. 

Believe me, carrying around the phrase "methods and instance variables" 
wherever you go isn't easy. It's much better to give these things one name 
and be done with it. That's why both methods and instance variables are 
called members of a class. 



DropBooks 
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class MyClass { 

int myVariable; 



id myMethod( ) { 



Members Versus classes 

At this point, you make an important distinction. Think about Java's public 
keyword. As you may already know from previous chapters, you can put 
publ i c in front of a member. For example, you can write 

public static void main(String args[]) { 

or 

public amountlnAccount = 50.22; 

These uses of the public keyword come as no big surprise. What you may 
not already know is that you can put the public keyword in front of a class. 
For example, you can write 

public class Drawing { 

// Your code goes here 

) 

In Java, the publ i c keyword has two slightly different meanings — one mean- 
ing for members, and another meaning for classes. Most of this chapter deals 
with the meaning of publ i c (and of other such keywords) for members. The 
last part of this chapter (appropriately titled "Access Modifiers for Java 
Classes") deals with the meaning for classes. 
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Access modifiers for members 



; section is about members. But that doesn't mean that you can 
va classes. Members or not, the Java class is still where all the 
action takes place. Each instance variable is declared in a particular class, 
belongs to that class, and is a member of that class. The same is true of meth- 
ods. Each method is declared in a particular class, belongs to that class, and 
is a member of that class. Can you use a certain member name in a particular 
place in your code? To begin answering the question, you check to see 
whether that place is inside or outside of the member's class: 

i>* If the member is private, only code that's inside the member's class can 
refer directly to that member's name. 

class SomeClass { 

private int myVariable = 10; 

} 



class SomeOtherCl ass { 




public static void main(String args[]) { 
SomeClass someObject = new SomeClassO; 





//Th 

Syst 

) 

} 


is doesn't 

em . out .pri 


work: 
ntl n ( some 


Dbject.myVariabl e 


) ; 


If the member is public, any 
name. 


code can refer directly to that member's 



class SomeClass { 

public int myVariable = 10; 

} 



class SomeOtherCl ass { 



public static void main(String args[]) ( 
SomeClass someObject = new SomeClassO 



//This works: 

System . out . pri ntl n (someObject .my Vari abl e) ; 



Figures 15-1 through 15-3 illustrate the ideas in a slightly different way. 
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Figure 15-1: 
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subclasses. 
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Figure 15-3: 

The range of 
code in 
which a 
private 
variable or 
method can 
be used 
(shaded). 



class2 

extends classl 



class3 

extends class2 



classA 



classB 

extends classA 

private variable 



classC 

extends classB 



classX 



classY 

extends classX 



classZ 

extends classY 



Putting a drawing on a frame 

To make this business about access modifiers clear, you need an example or 
two. In this chapter's first example, almost everything is public. With public 
access, you don't have to worry about who can use what. 

The code for this first example comes in several parts. The first part, which is 
in Listing 15-1, displays an ArtFrame. On the face of the ArtFrame is a 
Drawing. If all the right pieces are in place, running the code of Listing 15-1 
displays a window like the one in Figure 15-4. 



Listing 1 5-1 : Displaying a Frame 

import com. burdbrai n . drawi ngs . *; 
import com. burdb rain. frames .ArtFrame; 

class ShowFrame I 

public static void main(String args[]) { 

ArtFrame artFrame = new ArtFrame(new DrawingO); 

artFrame.setSize(200, 100); 
artFrame. setVisible(true) ; 

) 

) 
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The code in Listing 15-1 creates a new ArtFrame instance. You may suspect 
that ArtFrame is a subclass of a Java frame class, and that's certainly 
the case. Chapter 9 says that Java frames are, by default, invisible. So, in 
Listing 15-1, to make the ArtFrame instance visible, you call the setVi si bl e 
method. 

Now notice that Listing 15-1 starts with two import declarations. The 
first import declaration allows you to abbreviate any name from the 
com.burdbrain.drawings package. The second import declaration 
allows you to abbreviate the name ArtFrame. 

For a review of import declarations, see Chapter 4. 

The detective in you may be thinking, "He must have written more code 
(code that I don't see here) and put that code in packages that he named 
com.burdbrain.drawings and com. burdbrain. frames." And, indeed, you are cor- 
rect. To make Listing 15-1 work, I need to create something called a Drawing, 
and I'm putting all my drawings in the com. burdbra in. drawings package. 
I also need an ArtFrame class, and I'm putting all such classes in my 
com . burdbrai n . frames package. 

So, really, what's a Drawi ng? Well, if you're so anxious to know, look at 
Listing 15-2. 

Listing 15-2: The Drawing Class 

package com.burdbrain.drawings; 

import j ava . awt . Graphi cs ; 

public class Drawing { 

public int x = 40, y = 40, width = 40, height = 40; 

public void paint(Graphics g) { 

g.drawOval (x, y, width, height); 

) 

) 

The code for the Drawing class is pretty slim. It contains a few int variables 
and a pai nt method. That's all. Well, when I create my classes, I try to keep 
'em lean. Anyway, here are some notes about my Drawi ng class: 
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At the top of the code is a package declaration. Lo and behold! I've 
made my Drawi ng class belong to a package — the com . burdbrai n . 
i ngs package. I didn't pull this package name out of the air. The 
ention (handed down by the people at Sun Microsystems) says that 
you start a package name by reversing the parts of your domain name, 
so I reversed burdbra i n . com. Then, you add one or more descriptive 
names, separated by dots. I added the name drawings because I intend 
to put all my drawing goodies in this package. 

i>* The Drawi ng class is public. A public class is vulnerable to intrusion 
from the outside. So in general, I avoid plastering the public keyword in 
front of any old class. But in Listing 15-2, 1 have to declare my Drawi ng 
class to be public. If I don't, classes that aren't in the com. burdbrai n. 
drawings package can't use the goodies in Listing 15-2. In particular, 
the line 

ArtFrame artFrame = new ArtFrame(new DrawingO); 

in Listing 15-1 is illegal unless the Drawi ng class is public. 

For more information on public and nonpublic classes, see the section 
entitled "Access Modifiers for Java Classes," later in this chapter. 

V The code has a pai nt method. This paint method uses a standard Java 
trick for making things appear on-screen. The parameter g in Listing 15-2 
is called a graphics buffer. To make things appear, all you do is draw on 
this graphics buffer, and the buffer is eventually rendered on the com- 
puter screen. 

Here's a little more detail: In Listing 15-2, the paint method takes a g 
parameter. This g parameter refers to an instance of the j ava . awt . 
Graphi cs class. Because aGraphics instance is a buffer, the things that 
you put onto this buffer are eventually displayed on the screen. Like all 
instances of the Java, awt . Graphi cs class, this buffer has several draw- 
ing methods — one of them being d r a wO v a 1 . When you call d r a wO v a 1 , 
you specify a starting position (x pixels from the left edge of the frame 
and y pixels from the top of the frame). You also specify an oval size by 
putting numbers of pixels in the width and height parameters. Calling 
the d r a wO v a 1 method puts a little round thing into the Graphics buffer. 
That Graphi cs buffer, round thing and all, is displayed on-screen. 



Directory structure 

The code in Listing 15-2 belongs to the com .burdbra i n .drawi ngs package. 
When you put a class into a package, you have to create a directory structure 
that mirrors the name of the package. If you use JCreator, building this direc- 
tory structure is easy. (See the "Using Java packages in JCreator" section, later 
in this chapter.) In fact, if you load JCreator from this book's CD-ROM, the 
directory structures for all the book's examples are installed automatically. 
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Even if you don't use JCreator, understanding this directory business is 
handy. To house code that's in the com. burdbra in. drawings package, you 
ave three directories: acorn directory a subdirectory of com named 
ii n , and a subdirectory of burdbra in named drawings. The overall 
directory structure is shown in Figure 15-5. 




If you don't have your code in appropriate directories, you get a repulsive 
and disgusting NoClassDefFoundError. Believe me, this error is never 
fun to get. When you see this error, you don't have any clues to help you 
figure out where the missing class is or where the compiler expects to find it. 
If you stay calm, you can figure out all this stuff on your own. If you panic, 
you'll be poking around for hours. As a seasoned Java programmer, I can 
remember plenty of scraped knuckles that came from this heinous 
NoClassDefFoundError. 



The directory that houses this project's code 
(a subdirectory of JCreator's MyProjects directory) 

ShowFrame (Listing 15-1) 
in unnamed package 



com 



Figure 15-5: 

The files 
and 

directories 
in your 
project. 



burdbrai n 




drawings 



frames 



Drawi ng (Listing 15-2) 
in package com . burdbrai n . drawi ngs 



ArtFrame (Listing 15-3) 
in packagecom. burdbra in. frames 



Using JaVa packages in JCreator 

When you become a seasoned Java programmer, you'll put your own 
Java programs into your own packages. If you use JCreator, this process 
is easy. Imagine that you're writing a program as part of your new 

com.myhomedomain .stuff package. 



CD- 1 0 Bonus Chapter 



DropBook^ 



package com. myhomedomai n . stuff ; 
MyCode { 



public static void mai n ( Stri ng args[]) ( 
System . out . pri ntl n (" I ' m in a package. 



This is how you make a new My Code. Java file in JCreator: 

1. Follow Steps 1 through 7 in the last section of Chapter 3. 

In these steps, you start JCreator, open a workspace, and create a proj- 
ect. The steps are the same whether you work with packages or not. 

2. Follow Steps 8 and 9 in the last section of Chapter 3. 

In these steps, you begin creating a new Java class. A Class Wizard 
dialog box is showing on your screen. You can see the wizard's Class 
Settings page. (See Figure 15-6.) 

3. In the dialog box's Package text box, type the name of the package 
that will be housing your code. (See Figure 15-6.) 

As you type a dotted package name (like com.myhomedomain.stuff), 
JCreator automatically creates the appropriate directory structure 
(like conAmyhomedomai n\stuf f). To see this for yourself, check the 
Location field in Figure 15-6. 



Figure 15-6: 

Putting a 
Java class 
into a 
package. 



Class Wizanl 



class Settings 

Specify the settings for the class 



-*: Class Settings 

Implement Interfaces 
Add Methods 
Add Members 



MyCode 



Location : iojectsyNewPtojectWithPackage\com\rnyhornedomain\stuff 



Superclass : java. lang.Object 
Package : corn, myhorriedomain. stuff 
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□ Final 
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□ Generate default constructor 

□ Generate main method 



Help 



4. Click Finish, and then type your Java code. 

That's all you have to do. 
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program in Listing 15-1. 
The Java compiler pokes through the code and 
stumbles upon some missing pieces. First 
there's this thing called an ArtFrame. Then 
you have this Drawi ng business. Listing 15-1 
defines a class named ShowFrame, not 
ArtFrame or Drawi ng. So where does the 
compiler go for information about the 
ArtFrame and Drawing classes? 

If you stop to think about it, the problem can 
be daunting. Should the compiler go searching 
all over your hard drive for files named 
ArtFrame. Java or Draw ing. class? How 
large is your new hard drive? 120GB? 240GB? 
6,000,000GB? And what about references to files 
on network drives? The search space is poten- 
tially unlimited. What if the compiler eventually 
resolves all these issues? Then you try to run 
your code and the Java Virtual Machine (JVM) 
starts searching all over again. (For info on the 
Java Virtual Machine, see Chapter 2.) 

To tame this problem, Java defines something 
called a CLASSPATH. The CLASSPATH is a list 
of places where the compiler and the JVM look 
for code. JCreator buries this CLASSPATH deep 
inside its program options. That's why you don't 
have to think about the CLASSPATH when 
you run this book's examples. (In JCreator, the 



ing for files in all the right places 



settings for certain JDK tools include the text 
-classpath "$[ClassPath]". Take my 
word for it -4bis fixes the problem for most 
small programming projects.) 

The non-JCreator world has several ways to set 
a CLASSPATH. Some programmers create a 
new CLASSPATH each time they run a Java 
program. Others create a system-wide 
CLASSPATH variable. (If you're familiar with 
the PATH variable on Windows and UNIX 
computers, you may already know how this 
stuff works.) One way or another, the compiler 
and the JVM need a list of places to look 
for code. Without such a list, these Java 
tools don't look anywhere. They don't find 
classes like ArtFrame or Drawing. You 
get a cannot find symbol message or a 
NoCl assDef FoundError message, and 
you're very unhappy. 

If you installed JCreator from this book's 
CD-ROM, you don't have to think about all 
this. If not, or if you do fancy things with Java 
packages, a healthy understanding of the 
CLASSPATH may be useful to you. If so, I rec- 
ommend a visit to this book's Web site. At the 
Web site you can find out more about the intri- 
cacies of Java's CLASSPATH. 



Making a frame 

This chapter's first three listings develop one multipart example. This section 
has the last of three pieces in that example. This last piece isn't crucial for 
the understanding of access modifiers, which is the main topic of this chap- 
ter. So, if you want to skip past the explanation of Listing 15-3, you can skip it 
without losing the chapter's thread. On the other hand, if you want to know 
more about the Java Swi ng classes, read on. 
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ckage com. burdbrain. frames; 




com.burdbra in. drawings.*; 
import j avax . swi ng . J Frame ; 
import j ava . awt . Graphi cs ; 

public class ArtFrame extends JFrame { 
Drawing drawing; 

public ArtFrame( Drawi ng drawing) { 
this. drawing = drawing; 
setTi tl e ( "Abstract Art"); 
setDefaultCl oseOperati on ( EXIT_0N_CL0SE ) 

) 

public void paint(Graphics g) { 
drawing. pai nt ( g ) ; 

) 



Listing 15-3 has all the gadgetry that you need for putting a drawing on a 
Java frame. The code uses several names from the Java API (Application 
Programming Interface). I explain most of these names in Chapters 9 and 10. 

The only new name in Listing 15-3 is the word pai nt. The pai nt method in 
Listing 1 5-3 defers to another paint method — the paint method belonging 
to a Drawi ng object. The ArtFrame object creates a floating window on your 
computer screen. What's drawn in that floating window depends on whatever 
Drawi ng object was passed to the ArtFrame constructor. 

If you trace the flow of Listings 15-1 through 15-3, you may notice something 
peculiar. The pai nt method in Listing 15-3 never seems to be called. Well, for 
many of Java's window-making components, you just declare a pa i nt method 
and let the method sit there quietly in the code. When the program runs, the 
computer calls the pai nt method automatically. 

That's what happens with javax.swing.JFrame objects. In Listing 15-3, the 
frame's pai nt method is called from behind the scenes. Then, the frame's 
pai nt method calls the Drawi ng object's pai nt method, which in turn, draws 
an oval on the frame. That's how you get the stuff you see in Figure 15-4. 



Sneaking AuJay from the Original Code 

Your preferred software vendor, Burd Brain Consulting, has sold you two 
files — Drawi ng . cl ass and ArtFrame . cl ass. As a customer, you can't see 
the code inside the files Drawi ng .Java and ArtFrame . Java. So, you have 
to live with whatever happens to be inside these two files. (If only you'd 
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purchased a copy oiJava 2 For Dummies, 2nd Edition, which has the code for 
these files in Listings 15-2 and 15-3!) Anyway, you want to tweak the way the 
in Figure 15-4 so that it's a bit wider. To do this, you create a sub- 
e Drawi ng class — Drawi ngWi de — and put it in Listing 15-4. 



Listing 1 5-4: A Subclass of the Drawing Class 

import com.burdbra in. drawings.*; 
import j ava . awt . Graphi cs ; 



public class DrawingWide extends Drawing { 
int width = 100, height = 30; 

public void paint(Graphics g) { 

g.drawOval (x, y, width, height); 

) 

) 



To make use of the code in Listing 15-4, you remember to change one of the 
lines in Listing 15-1. You change the line to 

ArtFrame artFrame = new ArtFrame(new DrawingWide( ) ) ; 

Listing 15-4 defines a subclass of the original Drawi ng class. In that subclass, 
you override the original class's width and height variables and the original 
class's paint method. The frame that you get is shown in Figure 15-7. 



Figure 15-7: 

Another art 
frame. 




In passing, you may notice that the code in Listing 15-4 doesn't start with a 
package declaration. This means that your whole collection of files comes 
from the following three packages: 

V The com. burdbrai n. drawi ngs package. The original Drawing class 
from Listing 15-2 is in this package. 

V The com. burdbrai n. frames package. The ArtFrame class from 
Listing 15-3 is in this package. 

v 0 An ever-present, unnamed package. In Java, when you don't start a file 
with a package declaration, all the code in that file goes into one big, 
unnamed package. Listings 15-1 and 15-4 are in the same unnamed pack- 
age. In fact, most of the listings from the first 12 chapters of this book 
are in Java's unnamed package. 



C/)-/4 Bonus Chapter 



class ana 

DropBodte 

whose na 



At this point, your project has two drawing classes — the original Drawi ng 
class and your new Drawi ngWi de class. Similar as these classes may be, 

in two separate packages. That's not surprising. The Drawing class, 
d by your friends at Burd Brain Consulting, lives in a package 
whose name starts with com.burdbrain. But you developed Drawi ngWi de on 
your own, so you shouldn't put it in a com . burdbra i n package. The most 
sensible thing to do is to put it in one of your own packages, such as 
com. my home doma in. drawi ngs, but putting your class in the unnamed 
package will do for now. 

One way or another, your Drawi ngWi de subclass compiles and runs as 
planned. You go home, beaming with the confidence of having written useful, 
working code. 



Default access 

If you're reading these paragraphs in order, you know that the last example 
ends very happily. The code in Listing 15-4 runs like a charm. Everyone, 
including my wonderful editor, Paul Levesque, is happy. 

But, wait! Do you ever wonder what life would be like if you hadn't chosen 
that particular career, dated that certain someone, or read that certain 
For Dummies book? In this section, I roll back the clock a bit to show you 
what would have happened if one word had been omitted from the code in 
Listing 15-2. 

Dealing with different versions of a program can give you vertigo, so I start 
this discussion by describing what you've got. First, you have a Drawi ng 
class. In this class, the variables aren't declared to be public and have the 
default access. The Drawi ng class lives in the com . burdbrai n .drawi ngs 
package. (See Listing 15-5.) 



Listing 1 5-5: Variables with Default Access 



package com. burdbrai n. drawi ngs ; 




import j ava . awt . Graphi cs ; 




public class Drawing { 




int x = 40, y = 40, width = 


= 40, height = 40; 


public void paint(Graphics 


g) I 


g.drawOval (x, y, width. 

) 

) 


. height); 



Chapter 15: Sharing Names among the Parts of a Java Program 



CD-I 5 



DropBoqfe 



Next, you have a Drawi ngWi de subclass (copied, for your convenience, in 
Listing 15-6). The Drawi ngWi de class is in Java's unnamed package. 



5-6: A Failed Attempt to Create a Subclass 



import com.burdbra in. drawings.*; 
import j ava . awt . Graphi cs ; 

public class DrawingWide extends Drawing 
int width = 100, height = 30; 

public void paint(Graphics g) { 

g.drawOval (x, y, width, height); 

) 





The trouble is that the whole thing falls apart at the seams. The code in 
Listing 15-6 doesn't compile. Instead, you get the following error messages: 

x is not public in com . burdbrai n . drawi ngs . Drawi ng ; 

cannot be accessed from outside package 

y is not public in com . burdbrai n . drawi ngs . Drawi ng ; 

cannot be accessed from outside package 

The code doesn't compile, because an instance variable that has default 
access can't be directly referenced outside its package — not even by a sub- 
class of the class containing the variable. The same holds true for any meth- 
ods that have default access. 

A class's instance variables and methods are called members of the class. The 
rules for access, default and otherwise, apply to all members of classes. 

The access rules that I describe in this chapter don't apply to method-local 
variables. A method-local variable can be accessed only within its own 
method. 

For the rundown on method-local variables, see Chapter 10. 

In Java, the default access for a member of a class is package-wide access. 
A member declared without the word public, private, or protected in front 
of it is accessible in the package in which its class resides. Figures 15-8 and 
15-9 illustrate the point. 
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Figure 15-8: 
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The names of packages, with all their dots and subparts, can be slightly mis- 
leading. For instance, when you write a program that responds to button 
normally import classes from two separate packages. On one 
may have import j a va . awt . * ; . On another line, you may have 
import Java. awt. event.*;. Importing all classes from the j ava . awt pack- 
age doesn't automatically import classes from the Java. awt. event package. 



Crautdnq back into the package 

I love getting things in the mail. At worst, it's junk mail that I can throw right 
into the trash. At best, it's something I can use, a new toy, or something 
somebody sent especially for me. 

Well, today is my lucky day. Somebody from Burd Brain Consulting sent a 
subclass of the Drawing class. It's essentially the same as the code in Listing 
15-6. The only difference is that this new DrawingWideBB class lives inside 
the com . burdbra i n . drawi ngs package. The code is shown in Listing 15-7. 
To run this code, I have to modify Listing 15-1 with the line 

ArtFrame artFrame = new ArtFrame(new Drawi ngWi deBB( )) ; 



Listing 1 5-7: Yes, Virginia, This Is a Subclass 




package com. burdbrai n. drawi ngs ; 




import j ava . awt . Graphi cs ; 




public class DrawingWideBB extends Drawing { 
int width = 100, height = 30; 




public void paint(Graphics g) { 

g.drawOval (x, y, width, height); 

) 

) 



When you run Listing 15-7 alongside the Drawing class in Listing 15-5, every- 
thing works just fine. The reason? It's because Drawing and Drawi ngWi deBB 
are in the same package. Look back at Figure 15-9 and notice the shaded 
region that spans across an entire package. Being in the same package, the 
code in the DrawingWideBB class has every right to use the x and y 
variables, which are defined with default access in the Drawi ng class. 
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as first getting to know Java, I thought the word protected meant nice 
and secure, or something like that. "Wow, that variable is protected. It must 
be hard to get at." Well, this notion turned out to be wrong. In Java, a member 
that's protected is less hidden, less secure, and easier to use than one that 
has default access. The concept is rather strange. 

Think of protected access this way. You start with an instance variable that has 
default access (a variable without the word public, private, or protected in its 
declaration). That variable can be accessed only inside the package in which 
it lives. Now add the word protected to the front of the variable's declaration. 
Suddenly, classes outside that variable's package have some access to the 
variable. A subclass (of the class in which the variable is declared) can now 
reference the variable. You can also reference the variable from a sub-subclass, 
a sub-sub-subclass, and so on. Any descendent class will do. For an example, 
see Listings 15-8 and 15-9. 



Listing 1 5-8: Protected Variables 

package com. burdbrai n. drawn ngs ; 

import j ava . awt . Graphi cs ; 

public class Drawing I 

protected int x = 40, y = 40, width = 40, height = 40; 

public void paint(Graphics g) { 

g.drawOval (x, y, width, height); 

) 

) 



Listing 15-9: The Subclass from the Blue Lagoon, Part II 

import com.burdbra in. drawings.*; 
import j ava . awt . Graphi cs ; 

public class DrawingWide extends Drawing { 
int width = 100, height = 30; 

public void paint(Graphics g) I 

g.drawOval (x, y, width, height); 

) 

) 

Listing 15-8 defines the Drawing class. Listing 15-9 defines DrawingWide, 
which is a subclass of the Drawing class. 
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In the Drawi ng class, the x, y, wi dth, and height variables are protected. 
The Drawi ngWi de class has its own wi dth and height variables, but 
Wide references the x and y variables that are defined in the 
awing class. That's okay even though Drawi ngWi de isn't in the 
same package as its parent Drawing class. (The Drawing class is in the 
com . burdbrai n . drawi ngs package; the Drawi ngWi de class is in Java's 
great, unnamed package.) It's okay because the x and y variables are pro- 
tected in the Drawing class. 

Compare Figures 15-9 and 15-10. Notice the extra bit of shading in Figure 15-10. 
A subclass can access a protected member of a class, even if that subclass 
belongs to some other package. 

Do you work with a team of programmers? Do people from outside your team 
use their own team's package names? If so, when they use your code, they 
may make subclasses of the classes that you've defined. This is where pro- 
tected access comes in handy. Use protected access when you want people 
from outside your team to make direct references to your code's variables or 
methods. 



Figure 15-10: 

The range of 
code in 
which a 
protected 
variable or 
method can 
be used 
(shaded). 
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A package 



Another package 



Yet another package 
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Those people from Burd Brain Consulting are sending you one piece of soft- 
ware after another. This time, they've sent an alternative to the ShowFrame 
class — the class in Listing 15-1. This new ShowFrameWi deBB class displays a 
wider oval (how exciting!), but it does this without creating a subclass of the 
old Drawing class. Instead, the new ShowFrameWi deBB code creates a 
Drawi ng instance and then changes the value of the instance's wi dth and 
height variables. The code is shown in Listing 15-10. 

Listing 1 5-1 0: Drawing a Wider Oval 

package com. burdbrai n. drawi ngs ; 

import com.burdbrain.frames.ArtFrame; 

class ShowFrameWi deBB { 

public static void main(String args[]) { 
Drawing drawing = new DrawingO; 
drawi ng . wi dth = 100; 
drawi ng . hei ght = 30; 

ArtFrame artFrame = new ArtFrame(drawing) ; 
artFrame. setSize(200, 100); 
artFrame. setVisible(true) ; 

) 

) 

So, here's the story. This ShowFrameWi deBB class in Listing 15-10 is in the 
same package as the Drawi ng class (the com . burdbra i n .drawi ngs pack- 
age). But ShowFrameWi deBB isn't a subclass of the Drawi ng class. 

Now imagine compiling ShowFrameWi deBB with the Drawing class that's 
shown in Listing 15-8 — the class with all those protected variables. What 
happens? Well, everything goes smoothly, because a protected member is 
available in two (somewhat unrelated) places. Look again at Figure 15-10. 
A protected member is available to subclasses outside the package, but the 
member is also available to code (subclasses or not) within the member's 
package. 

Listing 15-10 has amain method, which is inside a class, which is in turn 
inside the com. burdbra in. drawi ngs package. With a development environ- 
ment like JCreator, you don't think twice about running amain method that's 
in a named package. But if you run programs from the command line (or if 
your development environment doesn't find ma i n methods on its own), you 
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may need to wield names like com.burdbrain.drawings.ShowFrameWideBB 
(the fully qualified name of the package in Listing 15-10). For tips on running 
jjieWi deBB in environments other than JCreator, visit this book's 





The real story about protected access is one step more complicated than the 
story that I describe in this section. The Java Language Specification men- 
tions a hair-splitting point about code being responsible for an object's imple- 
mentation. When you're first figuring out how to program in Java, don't 
worry about this point. Wait until you've written many Java programs. 
Then, when you stumble upon a va ri abl e has protected access error 
message, you can start worrying. Better yet, skip the worrying and take a 
careful look at the protected access section in the Java Language Specification. 

For info about the Java Language Specification, visit Chapter 3. 



Access Modifiers far Ja(/a Classes 

Maybe the things that you read about access modifiers for members make 
you a tad dizzy. After all, member access in Java is a very complicated sub- 
ject with lots of plot twists and cliffhangers. Well, the dizziness is over. 
Compared with the saga for variables and methods, the access story for 
classes is rather simple. 

A class can be either public or nonpublic. If you see something like 

pub! i c cl ass Drawing 

then you're looking at the declaration of a public class. But, if you see plain 
old 

class ShowFrame 
then the class that's being declared isn't public. 



Public classes 

If a class is public, you can refer to the class from anywhere in your code. Of 
course, some restrictions apply. You must obey all the rules in this chapter's 
"Directory structure" section. If you're creating code on your own, you have 
to follow the steps in this chapter's "Using Java packages in JCreator" section. 

You must also refer to a packaged class properly. For example, in Listing 15-1, 
you can write 
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import com.burdbra in. drawings.*; 
imDort com.burdbrain.frames.ArtFrame; 

e artFrame = new ArtFrame(new Drawing()); 

or you can do without the import declarations and write 

com . burdbrai n . frames .Art Frame artFrame = 
new com.burdbra in. frames. ArtFrame 

(new com.burdbra in. draw ings. Draw ing()); 

One way or another, your code must acknowledge the fact that the ArtFrame 
and Drawing classes are in named packages. 



Nonpublic classes 

If a class isn't public, you can refer to the class only from code within the 
class's package. 



I tried it. First, I went back to Listing 15-2 and deleted the word public. 
I turned pub! i c class Drawi ng into plain old cl ass Drawi ng, like this: 



package com. burdbrai n. drawi ngs ; 






import j ava . awt . Graphi cs ; 








class Drawing { 

publ i c i nt x = 40 , y 


= 40, 


width = 40, height = 


40; 


public void paint(Graphics 
g.drawOval (x, y, width 

) 

) 


g) ( 

, height); 





Then I compiled the code in Listing 15-7. Everything was peachy because 
Listing 15-7 starts with the following lines: 



package com.burdbra in. draw ings; 

public class Drawi ngWi deBB extends Drawing 

Because both pieces of code are in the same com.burdbra in. draw ings 
package, access from Drawi ngWi deBB back to the nonpublic Drawing class 
was no problem at all. 
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But then I tried to compile the code in Listing 15-3. The code in Listing 15-3 
begins with 



That code isn't in the com.burdbra in. drawings package. So when the com- 
puter reached the line 

Drawing drawing; 

from Listing 15-3, the computer went poof! To be more precise, the computer 
displayed this message: 

com . burdbrai n . drawi ngs . Drawi ng is not public 

in com. burdbrai n . drawi ngs ; 

cannot be accessed from outside package 

Well, I guess I got what was coming to me. 

Things are never as simple as they seem. The rules that I describe in this 
section apply to almost every class in this book. But Java's inner classes 
(which I introduce in Chapter 9) follow a different set of rules. Fortunately a 
typical novice programmer has little contact with inner classes. The only 
inner classes in this book are disguised as en urn types. So for now, you can 
live very happily with the rules that I describe in this section. 




com.burdbra in. frames; 
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Chapter 16 

0 Responding to Keystrokes 
and Mouse Clicks 



In This Chapter 

Creating code to handle mouse clicks (and other such events) 
Writing and using a Java interface 



f 

#n the late 1980s, I bought my first mouse. I paid $100 and, because I didn't 
«C really need a mouse, I checked with my wife before buying it. (At the time, 
my computer ran a hybrid text/windowed environment. Anything that I could 
do with a mouse, I could just as easily do with the Alt key.) 

Now it's the 21st century. The last ten mice that I got were free. Ordinary 
ones just fall into my lap somehow. A few exotic mice were on sale at the 
local computer superstore. One cost $10 and came with a $10 rebate. 

As I write this chapter, I'm using the most recent addition to my collection — 
an official For Dummies mouse. This yellow and white beauty has a little com- 
partment filled with water. Instead of a snowy Atlantic City scene, the water 
surrounds a tiny Dummies Man charm. It's so cute. It was a present from the 
folks at Wiley Publishing. 



Go On . . . Click That Button 

In previous chapters, I create windows that don't do much. A typical window 
displays some information but doesn't have any interactive elements. Well, 
the time has come to change all that. This chapter's first example is a window 
with a button on it. When the user clicks the button, darn it, something hap- 
pens. The code is shown in Listing 16-1. 
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Listing 16-1: A Guessing Game 
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import 
import 

class GameFrame extends JFrame implements Acti onLi stener { 

int randomNumber = new Random( ) . nextlntC 10 ) + 1; 
int numGuesses = 0; 

JTextField textField = new JTextField(5) ; 

JButton button = new JButton( "Guess" ) ; 

JLabel label = new J Label ( numGuesses + " guesses"); 

publ i c GameFrame( ) { 

setDefaul tCl oseOperati on (J Frame . EX IT_0N_C LOSE ) ; 
setLayout ( new Fl owLayout( ) ) ; 
add(textField) ; 
add(button) ; 
addd abel ) ; 

button. a ddActi on Li stener (t hi s ) ; 

pack( ) ; 

setVi si bl e( true ) ; 

) 

public void acti onPerformed( Acti onEvent e) { 

String textFi el dText = textField. getText( ) ; 

if ( I nteger . parselnt( textFi el dText ) == randomNumber) I 
button .setEnabled(false); 

textFi el d . setText( text Fi el d . getText( ) + " Yes!"); 
textFi el d.setEnabled (false); 
} else { 

textFi el d . setText ( " " ) ; 

) 

numGuesses++; 
String guessWord = 

(numGuesses == 1) ? " guess" : " guesses"; 
1 abel . setText ( numGuesses + guessWord); 

) 

) 



Java. uti 1 . Random ; 

j avax . swi ng . * ; 

j ava . awt . Fl ow Lay out ; 

Java. a wt. event. Acti onEvent; 

j ava. awt. event. Act ionLi stener; 



Listing 16-2: Starting the Guessing Game 

class ShowGameFrame { 

public static void main(String args[]) { 
new GameFrame ( ) ; 
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Some snapshots from a run of this section's code are shown in Figures 16-1 
and 16-2. In a window, the user plays a guessing game. Behind the scenes, the 
chooses a secret number (a number from 1 to 10). Then the pro- 
lays a text field and a button. The user types a number in the text 
field and clicks the button. One of two things happens next: 



If the number that the user types isn't the same as the secret number, 
the computer posts the number of guesses made so far. The user gets to 
make another guess. 

If the number that the user types is the same as the secret number, the 
text field displays Yes!. Meanwhile, the game is over, so both the text 
field and the button become disabled. Both components have that gray, 
washed-out look, and neither component responds to keystrokes or 
mouse clicks. 



Figure 16-1: 

An incorrect 
guess. 





|8 I 


Guess 




2 guesses 









4*> 






Guess 


6 guesses 



In Listing 16-1, the code to create the frame, the button, and the text field 
isn't earth-shattering. I did similar things in Chapters 9 and 10. The 
JTextField class is new in this chapter, but a text field isn't much different 
from a button or a label. Like so many other components, the JTextFi el d 
class is defined in the javax. swing package. When you create a new 
JTextFi eld instance, you have the option of specifying a number of 
columns. In Listing 16-1, 1 create a text field that's five columns wide. 




Listing 16-1 uses a fancy operator to decide between the singular guess and 
the plural guesses. If you're not familiar with this use of the question mark 
and colon, see Chapter 11. 



Events and ei/ent handling 

The big news in Listing 16-1, shown in the previous section, is the handling of 
the user's button click. When you're working in a graphical user interface 
(GUI), anything the user does (like pressing a key, moving the mouse, clicking 
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the mouse, or whatever) is called an event. The code that responds to the 
user's press, movement, or click is called event-handling code. 



1 deals with the button-click event with three parts of its code: 



V The top of the GameFrame class declaration says that this class 

implements Acti on Li stener. 

The constructor for the GameFrame class adds this to the button's list 
of action listeners. 

V The code for the GameFrame class has an acti onPerf ormed method. 

Taken together, all three of these tricks make the GameFrame class handle 
button clicks. To understand how it works, you have to know about some- 
thing called an interface, which I discuss in the following section. 



The JaVa interface 

You may have noticed that, in Java, you never get a class to extend more than 
one parent class. In other words, you never say 

class DontDoThis extends FirstClass, SecondClass, ThirdClass 

A class can have only one parent class, and that's fine when you want your 
new class to be like a frame. But what if you want your new class to be like a 
frame and a button-click-listening thing? Can your new class be like both 
things? 

Yes, it can be. Java has this thing called an interface. An interface is like a 
class, but it's different. (So, what else is new? A cow is like a planet, but it's 
quite a bit different. Cows moo; planets hang in space.) Anyway, when you 
hear the word interface, you can start by thinking of a class. Then, in your 
head, note the following things: 

(*" A class can extend only one parent class, but a class can implement 
more than one interface. 

For instance, if you want GameFrame to listen for keystrokes as well as 
button clicks, you can say 

class GameFrame extends JFrame 

implements Acti onLi stener , ItemListener 

An interface's methods have no bodies of their own. 
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Here's a copy of the API code for the ActionListener interface: 
kage ja va . awt . event ; 

ort Java . uti 1 . EventLi stener ; 

public interface ActionListener extends EventLi stener { 

public void actionPerformed(ActionEvent e); 

) 

I've removed the code's comments, but I've avoided messing with the 
API code in any significant ways. In this code, the acti onPerf ormed 
method has no body — no curly braces and no statements to execute. 
In place of a body, there's just a semicolon. 

A method with no body, like the method defined in the Acti onLi stener 
interface, is called an abstract method. 

When you implement an interface, you provide bodies for all the 
interface's methods. 

That's why an acti onPerf ormed method is in Listing 16-1. By announc- 
ing that it will implement the ActionListener interface, the code in 
Listing 16-1 agrees that it will give meaning to the interface's 
acti onPerf ormed method. In this situation, giving meaning means 
declaring an acti onPerf ormed method with curly braces, a body, and 
maybe some statements to execute. 

When you announce that you're going to implement an interface, the 
Java compiler takes this announcement seriously. Later on in the code, 
if you fail to give meaning to any of the interface's methods, the compiler 
yells at you. 




If you're really lazy, you can quickly find out what methods need to be 
declared in your interface-implementing code. Try to compile the code, and 
the compiler lists all the methods that you should have declared but didn't. 



Threads of execution 

Here's a well-kept secret: Java programs are multithreaded, which means that 
several things are going on at once whenever you run a Java program. Sure, 
the computer is executing the code that you've written, but it's executing 
other code as well (code that you didn't write and don't see). All this code is 
being executed at the same time. While the computer executes your mai n 
method's statements, one after another, the computer takes time out, sneaks 
away briefly, and executes statements from some other, unseen methods. 
For most simple Java programs, these other methods are methods that are 
defined as part of the Java Virtual Machine (JVM). 



DropBookSp 




Cb~30 Bonus Chapter 



event-nar 

DropBodte 



For instance, Java has an event-handling thread. While your code runs, the 
event-handling thread's code runs in the background. The event-handling 

,code listens for mouse clicks and takes appropriate action whenever 
cks the mouse. Figure 16-3 illustrates how this works. 





Your code's thread 


The event handling thread 




setLayout(new FlowLayout(l); 


Did the user click the mouse? 




add(textField); 






add(button); 






add(label); 


Did the user click the mouse? 


Figure 16-3: 


button. addActionListener(this); 




pack(); 


Did the user click the mouse? 


Two Java 


setVisible(true); 


Yes? Okay, then. I'll call the 


threads. 




actionPerformed method. 



When the user clicks the button, the event-handling thread says, "Okay, the 
button was clicked. So, what should I do about that?" And the answer is, "Call 
some acti onPerf ormed methods." It's as if the event-handling thread had 
code that looks like this: 

if ( buttonJustGotCl i eked ( ) ) I 

objectl . acti on Perf ormed ( i nf oAboutTheCl i ck) ; 
object 2 .acti on Pe rf ormed ( i nf oAboutTheCl i ck ) ; 
object 3 .acti on Perf ormed ( i nf oAboutTheCl i ck ) ; 

) 

Of course, behind every answer is yet another question. In this situation, the 
follow-up question is, "Where does the event-handling thread find 
acti onPerf ormed methods to call?" And there's another question: "What if 
you don't want the event-handling thread to call certain acti onPerf ormed 
methods that are lurking in your code?" 

Well, that's why you call the addActi onLi stener method. In Listing 16-1, 
the call 

button. addActi onListener(th is); 

tells the event-handling thread, "Put this code's acti onPerf ormed method 
on your list of methods to be called. Call this code's acti onPerf ormed 
method whenever the button is clicked." 

So, that's how it works. To have the computer call an acti onPerf ormed 
method, you register the method with Java's event-handling thread. You do 
this registration by calling addActi on Li stener. The addActi on Li stener 
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method belongs to the object whose clicks (and other events) you're waiting 
for. In Listing 16-1, you're waiting for the button object to be clicked, and the 
pnLi stener method belongs to that button object. 
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The keyword this 



In Chapters 9 and 10, the keyword this gives you access to instance vari- 
ables from the code inside a method. So, what does the this keyword really 
mean? Well, compare it with the English phrase "state your name." 

/, (state your name), do solemnly swear, to uphold the constitution of the 
Philadelphia Central High School Photography Society. . . . 

The phrase "state your name" is a placeholder. It's a space in which each 
person puts his or her own name. 

/, Bob, do solemnly swear. . . . 
I, Fred, do solemnly swear. . . . 



Think of the pledge ("I ... do solemnly swear . . .") as a piece of code in a 
Java class. In that piece of code is the placeholder phrase, "state your name." 
Whenever an instance of the class (a person) executes the code (that is, 
takes the pledge), the instance fills in its own name in place of the phrase 
"state your name." 

The this keyword works the same way. It is sitting inside the code that 
defines the GameFrame class. Whenever an instance of GameFrame is con- 
structed, the instance calls addActionl_istener(this).In that call, the 
this keyword stands for the instance itself. 

button. addActionl_istener( thisGameFramelnstance ) ; 



By calling button. addActionl_istener(th is), the GameFrame instance 
is saying, "Add my acti on Pert ormed method to the list of methods that 
are called whenever the button is clicked." And indeed, the GameFrame 
instance has an acti onPerf ormed method. The GameFrame has to have an 
acti onPerf ormed method, because the GameFrame class implements the 
Acti on Li stener interface. It's funny how that all fits together. 



Inside the action Performed method 

The acti onPerf ormed method in Listing 16-1 uses a bunch of tricks from the 
Java API. Here's a brief list of tricks: 
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i>* Every instance of JText Fi el d (and of J Label) has methods — getText 
and setText. Calling getText fetches whatever string of characters is 
e component. Calling setText changes the characters that are in 
omponent. In Listing 16-1, judicious use of getText and setText 
pulls a number out of the text field and replaces the number with either 
nothing (the empty string " "), or the number, followed by the word Yes! 



Every component in the javax. swing package (JText Fi el d, 
JButton, or whatever) has a setEnabl ed method. When you call 
setEnabled(false), the component gets that limp, gray, washed-out 
look and can no longer receive button clicks or keystrokes. 




You can perform a test to make sure that the object referred to by the button 
variable is really the thing that was clicked. Just write if (e.getSourceO == 
button ). If your code has two buttons, buttonl and button2, you can test 
to find out which button was clicked. You can write i f (e . getSource ( ) == 
buttonl ) and i f (e . getSource ( ) == button2). 



Responding to Things Other Than 
Button Clicks 

When you know how to respond to one kind of event, responding to other 
kinds of events is easy. Listings 16-3 and 16-4 display a window that shows 
amounts as U.S. or U.K. currencies. The code in these listings responds to 
many kinds of events. Figures 16-4, 16-5, and 16-6 show some pictures of the 
code in action. 



Listing 16-3: Displaying the Local Currency 



import j avax . swi ng . * ; 

import j avax. swing. event. DocumentListener; 

import j avax. swing. event. DocumentEvent; 

import j ava . awt . FI owLayout ; 

import j ava . awt . Col or ; 

import j ava . awt . event .* ; 

import j ava . text . NumberFormat ; 

import j ava . uti 1 . Local e ; 

class MoneyFrame extends JFrame implements DocumentListener, 

ItemLi stener , 
MouseLi stener { 

JTextField textField = new JTextFi el d ( 5 ) ; 

JComboBox combo = new JComboBoxO; 

JLabel label = new JLabelC "); 
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NumberFormat currencyUS = 

Number Format .getCurrencylnstanceO; 
.mberFormat currencyUK = 

NumberFormat.getCurrencylnstance(Locale.UK) 



publ i c Money Frame( ) { 

setLayout(new Fl owLayout( ) ) ; 

add (text Field) ; 
combo . addltem( "US" ) ; 
combo . addltem( "UK" ) ; 
add(combo) ; 
add( label ) ; 

text Fi el d . get Document ( ) . addDocumentLi stener ( thi s ) ; 
combo . add I tern Li stener (thi s ) ; 
1 abel . addMouseLi stener (thi s ) ; 

setDefaultCl oseOperati on ( J Frame . EXIT_0N_CL0SE ) ; 



1 



setSizeOOO, 100) 
setVisibl e(true) ; 



void setTextOnLabel ( ) { 
String amountString 



try 



double amount = 

Double.parseDouble(textField.getTextO); 



i f ( combo . getSel ectedltem( ). equal s ( "US" ) ) 

amountString = currencyUS . format ( amount ) ; 

i f ( combo . getSel ectedltem( ). equal s ( "UK" ) ) 

amountString = currencyUK. format(amount) ; 

catch ( NumberFormatExcepti on e) ( 



1 



1 abel . setText ( amountStri ng ) ; 



public void i nsertUpdate( DocumentEvent d) 
setTextOnLabel ( ) ; 

) 



public void removeUpdate( DocumentEvent 
setTextOnLabel ( ) ; 

) 



d) 



(continued) 
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Listing 16-3 (continued) 
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ublic void changedUpdate ( DocumentEvent d) 



public void itemStateChanged( ItemEvent i) { 
setTextOnLabel ( ) ; 

} 



public void mouseEntered(MouseEvent m) I 
label .setForeground(Color.red); 

) 

public void mouseExi ted(MouseEvent m) ( 
label.setForeground(Color.black); 

) 

public void moused i cked(MouseEvent m) { 
) 

public void mousePressed(MouseEvent m) { 
) 

public void mouseRel eased(MouseEvent m) { 
^ ) 



Listing 16-4: Calling the Code 


in Listing 16-3 




class ShowMoney Frame { 

public static void mai 
new MoneyFrame( ) ; 

) 

) 


n(String args[] ) { 
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Figure 16-6: 

Drop Bo oks 



Okay, so Listing 16-3 is a little long. Even so, the outline of the code in 
Listing 16-3 isn't too bad. Here's what the outline looks like: 

class MoneyFrame extends JFrame implements DocumentLi stener , 

ItemLi stener , 
MouseLi stener { 

variable decl arati ons 

constructor for the MoneyFrame class 

decl arati on of a method named setTextOnLabel 



all the methods that are required because the class 
impl ements three i nterfaces 



The constructor in Listing 16-3 adds the following three components to the 
new MoneyFrame window: 

*<" A text field: In Figure 16-4, the user types 22 in the text field. 

i>* A combo box: In Figure 16-4, the combo box displays US. In Figure 16-5, 
the user selects an item in the box. In Figure 16-6, the selected item is UK. 

V A label: In Figure 16-4, the label displays $22.00. 

The MoneyFrame implements three interfaces — the DocumentLi stener, 
ItemLi stener, and MouseLi stener interfaces. Because it implements three 
interfaces, the code can listen for three different kinds of events. I discuss the 
interfaces and events in the following list: 

V DocumentLi stener: A class that implements the DocumentLi stener 
interface must have three methods named i nsertUpdate, removeUpdate, 
and changedUpdate. When you type a digit in a text field, the event- 
handling thread calls i nsertUpdate. Erasing a digit from the field gets 
the event-handling thread to call removeUpdate. 

In Listing 16-3, the i nsertUpdate and removeUpdate methods call 
setTextOnLabel. My setTextOnLabel method checks to see what's 
currently selected in the combo box. If the user selects the US option, 
the setTextOn Label method formats dollars. If the user selects the UK 
option, the setTextOnLabel method formats pounds. 
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By the way, if you're thinking in terms of real currency conversion, forget 



DropBook& a 



about it. This program just changes back and forth between a dollar sign 
a pound sign. Sure, there are easier ways to accomplish this task, 
ou've got bigger Javafish to fry. 



i>* ItemLi stener: A class that implements the ItemLi stener interface 
must have an i temStateChanged method. When you select an item in a 
combo box, the event-handling thread calls i temStateChanged. 

In Listing 16-3, when the user selects US or UK in the combo box, the 
event-handling thread calls the i temStateChanged method. In turn, the 
i temStateChanged method calls setTextOnLabel , and so on. 

Mouse Li stener: A class that implements the Mouse Li stener interface 
must have mouseEntered, mouseExi ted, moused i eked, mousePressed, 
and mouseRel eased methods. Implementing MouseLi stener is differ- 
ent from implementing A c t i o n L i stener. When you implement 
Acti onLi stener, as in Listing 16-1, the event-handling thread responds 
only to mouse clicks. But with MouseLi stener, the thread responds to 
the user pressing the mouse, releasing the mouse, and more. 

In Listing 16-3, the mouseEntered and mouseExi ted methods are called 
whenever you move over or away from the label. How do you know that 
the label is involved? Just look at the code in the Money Frame construc- 
tor. The 1 abel variable's addMouseLi stener method is the one that's 
called. 

Look at the mouseEntered and mouseExi ted methods in Listing 16-3. 
When mouseEntered or mouseExi ted is called, the computer forges 
ahead and calls setForeground. This setForeground method changes 
the color of the label's text. (Maybe you can see the red text in Figure 16-6; 
maybe you can't. I don't know whether colors appear in this CD-ROM 
chapter.) 

Isn't modern life wonderful? The Java API even has a Col or class with 
names like Color.red and Color. black. 



Listing 16-3 has several methods that aren't really used. For instance, when you 
implement MouseLi stener, your code has to have its own mouseRel eased 
method. You need the mouseRel eased method not because you're going to 
do anything special when the user releases the mouse button, but because 
you made a promise to the Java compiler and have to keep that promise. 
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Java Applets 



In This Chapter 

Creating a simple applet 
Building applet animation 

Putting buttons (and other such things) on an applet 



■ VI/ ith Java's first big burst onto the scene in 1995, the thing that made 
ww the language so popular was the notion of an applet. An applet is a 
Java program that sits inside a Web browser window. The applet has its own 
rectangular area on a Web page. The applet can display a drawing, show an 
image, make a figure move, respond to information from the user, and do all 
kinds of interesting things. When you put a real live computer program on a 
Web page, you open up a world of possibilities. 



Applets 101 



Listings 17-1 and 17-2 show you a very simple Java applet. The applet displays 
the words Java 2 For Dummies inside a rectangular box. (See Figure 17-1.) 



Listing 17-1: An Applet 

import j avax . swi ng . JAppl et ; 
import j ava . awt . Font ; 
import j ava . awt . Graphi cs ; 

public class SimpleApplet extends JApplet I 

publ i c void i ni t ( ) I 

setContentPane(new DummiesPanel ( ) ) ; 
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Listing 1 7-2: Some Helper Code for the Applet 

ipiport j avax . swi ng . J Panel ; 

JrOnKOOK^ Java, awt . Font ; 
■-^ ■ V/ I— / \y Vyiln^? java. awt. Graphics; 

class Dummi esPanel extends JPanel { 

public void paint(Graphics myGraphics) { 

myGraphics.drawRect(50, 60, 250, 75); 

myGraphi cs . setFont ( new Font( "Di al og" , Font. BOLD, 24)); 

myGraphi cs . drawStri ng( " Java 2 For Dummies", 55, 100); 




Figure 17-1: 

Nice title! 
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When you run the code in Listings 17-1 and 17-2, you don't execute amain 
method. Instead, you run a Web browser and the Web browser visits an 
HTML file. The HTML file includes a reference to the applet's Java code, and 
the applet appears on your Web page. Listing 17-3 shows a bare minimum 
HTML file. 

Listing 1 7-3: A One-Line Web Page 




<applet code=Simpl eAppl et width=350 hei ght=200X/appl et> 
For more information about HTML files, see Chapter 2. 

The easiest way to set things up is to put the HTML file and the applet's code 



in the same directory. If you installed JCreator from this book's CD-ROM, then 
Listings 17-1, 17-2, and 17-3 are already in one directory on your computer's 
hard drive. To run the applet, do the usual BuildOExecute Project business. 
Instead of running amain method, JCreator opens a Web browser and visits 
the HTML file in Listing 17-3. 
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For instructions on running applets in environments other than JCreator, visit 
this book's Web site. At that site, you can also read about the locations of 
s and applets. (You can find out how to put these files in separate 
jtqT^es. if necessary.) 

You can use JCreator's editor to make your own HTML files. You can create 
<appl et> tags like the one in Listing 17-3. Follow the second set of steps 
in the section entitled "Storing data in a file" in Chapter 8. To make an 
HTML file, don't name your file somename . txt. Instead, name your file some- 
name . htm or somename .html . With either the . htm or . html extension, 
JCreator recognizes the presence of a Web page and acts accordingly. (Even 
without JCreator, you still need the . htm or . html extension. The extension 
tells your Web browser what to do with your file.) 



Waiting to be catted 

When you look at the code in Listings 17-1 and 17-2, you may notice one 
thing — an applet doesn't have amain method. That's because an applet isn't 
a complete program. An applet is a class that contains methods, and your 
Web browser calls those methods (directly or indirectly). Do you see the 
i n i t method in Listing 17-1? The browser calls this i n i t method. Then the 
in it method's call tosetContentPane drags in the code from Listing 17-2. 

Now, take a look at the paint method in Listing 17-2. The browser calls this 
paint method automatically, and the paint method tells the browser how to 
draw your applet on the screen. 

For a list of applet methods that your Web browser calls, see the section 
entitled "The methods in an applet," later in this chapter. For a bit more infor- 
mation on the pa i nt method and its Graphi cs parameter, see Chapter 13. 



A public class 

Notice that the Simpl eAppl et in Listing 17-1 is a public class. If you create an 
applet, and you don't make the class public, you get anApplet not inited 
or a Loading Java Applet Fa i 1 ed error. To state things very plainly, any 
class that extends JAppl et must be public. If the class isn't public, your Web 
browser can't call the class's methods. 




To state things a little less plainly, a class can have either default access or 
publ i c access. The only code that can reference a def aul t access class is 
code that's in the same package as the default access class. Now remember 
that your Web browser tries to call methods that are buried inside your 
applet class. Because the Web browser isn't likely to be in the same package 
as your applet (believe me, it's not), the applet must be public. If the applet 
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isn't public, your Web browser's code (code that's not in the same package as 
the applet) can't call any of your applet's methods. 

^^b|^^J information on publ i c and def aul t access, see the section entitled 
"Access Modifiers for Java Classes" in Chapter 15. (You can find Chapter 15 
on the CD-ROM.) 
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The code in Listing 17-2 uses a few interesting Java API tricks. Here are some 
tricks that don't appear in any earlier chapters: 



drawRect: Draws an unfilled rectangle. 

Look at the call to drawRect in Listing 17-2. According to that call, the 
rectangle's upper-left corner is 50 pixels across and 60 pixels down from 
the upper-left corner of the panel. The rectangle's lower-right corner is 
250 pixels across and 75 pixels down from the upper-left corner of the 
panel. 

I wanted the rectangle to surround the words Java 2 For Dummies. 
To come up with numbers for the drawRect call, I used trial and 
error. However, you can make the program figure out how many 
pixels the words Java 2 For Dummies take up. To do this, you need the 
FontMetrics class. (For information on FontMetri cs, see the Java API 
documentation.) 

i>* The Font class: Describes the features of a character font. 

Listing 17-2 creates a bold, 24-point font with the Dialog typeface style. 
Other typeface styles include Dialoglnput, Monospaced, Serif, and 
SansSerif. 

drawStri ng: Draws a string of characters. 

Listing 17-2 draws the string "Java 2 For Dummi es" on the face of the 
panel. The string's lower-left corner is 55 pixels across and 100 pixels 
down from the upper-left corner of the panel. 



Making Things Mo</e 

This section's applet is cool because it's animated — you can see an odome- 
ter change on the screen. When you look at the code for this applet, you may 
think the code is quite complicated. Well, in a way, it is. A lot is going on 
when you use Java to create animation. On the other hand, the code for this 
applet is mostly boilerplate. To create your own animation, you can borrow 
most of this section's code. To see what I'm talking about, look at Listings 17-4 
and 17-5. 
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Listing 17-4: An Odometer Applet 
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import j avax . swi ng . JAppl et ; 




j avax . swi ng .Timer ; 
Java . awt . Col or ; 
import Java. awt. event. Act ionListener; 
import Java. awt. event. Act ionEvent; 

public class Odometer extends JApplet 

implements Acti onLi stener 

Timer timer; 



pub 1 i c void i ni t ( ) { 
OdometerPanel panel 



new OdometerPanel ( ) ; 



1 



panel. setBac kg round (Col or. white); 
setContentPane(panel ) ; 



publ ic void start( ) I 

if (timer == nul 1 ) { 

timer = new TimerdOO, this); 

timer . start( ) ; 
} else { 

timer . restart( ) ; 



publ i c void stop ( ) { 

if (timer ! = null) I 
timer . stop( ) ; 
timer = null; 

) 

) 

public void acti onPerf ormed(Acti onEvent e) { 
repaint( ) ; 

) 



Listing 17-5: The Odometer Panel 

import j avax . swi ng . J Panel ; 
import j ava . awt . Font ; 
import j ava . awt . Graphi cs ; 

class OdometerPanel extends JPanel I 
long hitCount = 239472938472L ; 



(continued) 
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Listing 1 7-5 (continued) 

blic void paint(Graphics myGraphics) { 

myGraphi cs . setFont 

(new Font( "Monospaced" , Font. PLAIN, 24)); 
my Graph ics.drawString 

("You are visitor number " + 
Long . toStri ng( hi tCount++) , 50, 50); 
) 

) 

For a snapshot of the odometer applet in action, see Figure 17-2. Notice the 
number in the figure. It's not the same as the starting value of the h i t Count 
variable. That's because, every 250 milliseconds, the applet adds 1 to the 
value of hi tCount and displays the new value. The odometer isn't reporting 
an honest hit count, but it's still really cute. 
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Figure 17-2: 

A popular 
Web site. 
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The methods in an applet 

Most of the method names in Listings 1 7-4 and 1 7-5 are standard for an 
applet. The Java API J A p p 1 e t and J P a n e 1 classes have default declarations 
for these methods, so you don't really have to declare these methods your- 
self. The only methods that you have to put in your code are the methods 
that you want to customize. 

Here's a list of JAppl et and J Panel methods that your Web browser auto- 
matically calls: 

i nit: The browser calls i n i t when you first visit the page containing 
the applet. Imagine that you close the Web browser. Later, you start the 
browser running again and revisit the page containing the applet. Then 
the browser calls the applet's i n i t method again. 

start: The browser calls start right after it calls i nit. If your applet 
performs any continuous work, you can begin that work's code in the 
applet's sta rt method. For instance, if your applet has any animation, 
the code to begin running that animation is in your start method. 
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f pai nt: The browser calls pai nt right after it calls start. The pai nt 

method has instructions for drawing your applet on the screen. For an 
^explanation, see Chapter 15. (You can find Chapter 15 on the CD-ROM). 

' browser can call paint several times. For instance, imagine that 
you cover part of the browser with another window. Or maybe you 
shrink the browser so that only part of the applet is showing. Later, 
when you uncover the applet or enlarge the browser window again, the 
browser calls the panel's pai nt method. 

stop: When the applet's work should be ceased, the browser calls the 
stop method. Say, for instance, that you click a link that takes you away 
from the page with the applet on it. Then the browser calls the applet's 
stop method. Later, when you revisit the page with the applet on it, the 
browser calls the applet's start method again. 
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What to put into aft these methods 

The code in Listings 17-4 and 17-5 uses a standard formula for creating anima- 
tion inside an applet. Here's a very brief explanation: 

V The applet implements the ActionListener interface. 

The start method creates a new timer with the following code: 

new Timer (100, this) 

Every 100 milliseconds (every tenth of a second) the timer in Listing 17-4 
rings its alarm. 

When it "rings its alarm," the timer actually gets Java to call an 
acti onPerf ormed method. And whose acti onPerf ormed method 
does Java call? Once again, the keyword this answers our question. In 
Listing 17-4, the word this refers to this very same code — this instance 
of the Odometer object that contains the new TimerdOO, this) call. 
So every tenth of a second, when the timer rings its alarm, Java calls the 
acti onPerf ormed method in Listing 17-4. How nice and tidy it is! 

V The acti onPerf ormed method calls the repa i nt method. Under the 
hood, a call to repaint always calls somebody's paint method. In this 
example, that somebody is the code in Listing 17-5. This paint method 
draws the words You are visitor number whatever on the screen. 

is* At some point, the day is done, and your browser calls the stop method. 
When this happens, the stop method tosses the timer into the dumper. 

If it weren't such standard code, I'd feel guilty for explaining this stuff so 
briefly. But, really, to achieve motion in your own applet, just copy Listings 17-4 
and 1 7-5. Then replace the listing's i n i t and paint methods with your own 
code. 
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So, what do you put in your i n i t and paint methods? 
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declare an i ni t method, the method should contain setup code 
he applet — stuff that happens once, the first time the applet is 
loaded. 




In Listing 17-4, the setup code fiddles with a panel: 

• It creates a panel by calling the OdometerPanel constructor. 

• It makes the panel's background white. (This ensures that the 
rectangle housing the applet blends nicely with the rest of the 
Web page.) 

• It forges a rock-solid connection between the panel and the applet. 
It does this by calling the setContentPane method. 

V The paint method describes a single snapshot of the applet's motion. 

In Listing 17-5, the pai nt method sets the graphics buffer's font, writes 
the hi t Count value on the screen, and then adds 1 to the hi tCount. 
(Who needs real visitors when you can increment your own h i t Count 
variable?) 

The value of the hi tCount variable starts high and becomes even 
higher. To store such big numbers, I give hi tCount the type 1 ong. I use 
the Long class's t o S t r i n g method to turn h i t C o u n t into a string of 
characters. This toString method is like the Integer class's parselnt 
method. 

I introduce the parselnt method in Chapter 11. 



To debug an applet, you can put calls to System. out. println in the applet's 
code. If you're running Internet Explorer, the println output appears in some- 
thing called the Java console. You can see the console by choosing ToolsO 
Sun Java Console from Internet Explorer's menu bar. 



Responding to Events in an Applet 

This section has an applet with interactive thingamajigs on it. This applet is 
just like the examples in Chapter 16. In fact, to create Listing 17-7, 1 started 
with the code in Listing 16-1.1 didn't do this out of laziness (although, heaven 
knows, I can certainly be lazy). I did it because applets are so much like Java 
frames. If you take the code for a frame and trim it down, you can usually 
create a decent applet. 
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Listing 1 7-6: A Guessing Game Applet 

ilnport j avax . swi ng . JAppl et ; 
1 li C\ CW\^^ java.awt.event.ActionListener; 

^ ■ w yj I— 9 \J \J$^$& j a va.awt. event. Act ion Event; 

public class GameApplet extends JApplet { 

publ i c voi d i ni t ( ) { 

setContentPane(new GamePanel ()) ; 

) 

) 



Listing 17-7: The Guessing Game Panel 

import j avax . swi ng .* ; 
import Java. a wt . event. Act ionListener; 
import Java. a wt. event. Act ionEvent; 
import j ava . uti 1 . Random ; 

class GamePanel extends JPanel implements Acti onLi stener { 
int randomNumber = new Random( ) . nextlnt( 10 ) + 1; 
int numGuesses = 0; 

JTextField textField = new JTextField(5) ; 

JButton button = new JButton( "Guess" ) ; 

JLabel label = new J Label ( numGuesses + " guesses"); 

GamePanel ( ) { 

add(textField) ; 
add(button) ; 
addd abel ) ; 

button.addActionListener(this); 

) 

public void acti onPerf ormed(Acti onEvent e) { 
String textFi el dText = textField. getText( ) ; 

if ( I nteger . parselnt( textFi el dText ) == randomNumber) { 
button. set En abled(false); 

textFi el d . setText( text Fi el d . getText( ) + " Yes!"); 
textFi el d . set Enabled (false); 
} else { 

textFi el d . setText ( " " ) ; 

) 

numGuesses++; 
String guessWord = 

(numGuesses == 1) ? " guess" : " guesses"; 
1 abel . setText ( numGuesses + guessWord); 
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To run the code in Listings 17-6 and 17-7, you need an HTML file: 

t code = "GameAppl et" width=225 hei ght=50X/appl et> 



guresl7-3 and 17-4 show you what happens when you run this section's 
listings. It's pretty much the same as what happens when you run the code in 
Listing 16-1. The big difference is that the applet appears as part of a Web 
page in a browser window. 



Figure 17-3: 

An incorrect 
guess. 
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The correct 
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Instead of noticing what code Listing 17-7 has, notice what code the listing 
doesn't have. To go from Listing 16-1 to Listing 17-7, 1 remove several lines. 

I don't bother calling setLayout. 

The default layout for an applet is Fl owLayout, which is just what I want. 
If you want info on how Fl owLayout works, see Chapter 9. 
I don't call the pack method. 

The width and height fields in the HTML applet tag determine the 
applet's size. 

V I don't call the setVi si bl e method. 

An applet is visible by default. 
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The only other change is between Listings 16-2 and 17-6. Like many other 
applets, Listing 17-6 has no ma i n method. Instead, Listing 17-6 has an i n i t 
tbo^You don't need a mai n method, because you never need to say new 
Ifyjy et ( ) anywhere in your code. The Web browser says it for you. 
Then, after the Web browser creates an instance of the GameAppl et class, the 
browser goes on and calls the instance's i ni t method. That's the standard 
scenario for the running of a Java applet. 
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Chapter 18 

sing Java Database Connectivity 



In This Chapter 

Connecting to a database 
Inserting values into a database 
Making queries to a database 



tM/henever I teach Java to professional programmers, I always hear the 
WW same old thing. "We don't need to make any cute little characters fly 
across the screen. No blinking buttons for us. We need to access databases. 
Yup, just show us how to write Java programs that talk to databases." 



So here it is, folks — Java Database Connectivity. 



Telling the System about \lour Database 

When I first started working with databases, my toughest problem was con- 
necting to a database. I had written all the Java code. (Well, I had copied all 
the Java code from some book.) The Java part was easy. The hard part was 
getting my code to find the database on the system. 

Part of the problem was that the way you get your code to talk to the data- 
base depends on the kind of system you have and the kind of database that 
you're running on your system. The books that I was using couldn't be too 
specific on all the details because the details (having nothing to do with Java) 
varied from one reader's computer to another. 

Well, in this chapter, I make some bold assumptions and try to give you some 
concrete advice. I assume that you're running Windows and that you have 
Microsoft Access installed on your computer. If my assumptions are incor- 
rect, then as far as connecting to the database goes, you're on your own. 
(All the Java code in this chapter still works, but you have to tackle the con- 
nection problem by yourself.) 



Cb~50 Bonus Chapter 



DropBooks- 



Anyway, just follow these steps to create an Access database on a Windows 
computer: 



se StartOSettingsOControl Panel. 

This opens the Windows Control Panel. What you do next depends on 
which version of Windows you use. 

In Windows 2000, select Administrative Tools. In Windows XP, first 
select Performance and Maintenance, and then select Administrative 
Tools. 

Either way, you get a list of tools. 

In the Administrative Tools list, double-click Data Sources (ODBC). 

This starts the ODBC Data Source Administrator, which is shown in 
Figure 18-1. 



Figure 18-1: 

The ODBC 
Data Source 
Admini- 
strator. 
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User Data Sources: 
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Microsoft Access Driver f.mdb] 





Coriligure... 



An ODBC User data source stores information about how to connect to 
the indicated data provider. A User data source is only visible to you, 
and can only be used on the current machine. 



Cancel | 



Help 




In the ODBC Data Source Administrator dialog box, select the User 
DSN tab. Then click the Add button. 

This opens up the Create New Data Source window, which is shown in 
Figure 18-2. 

If you run into trouble with the User DSN tab, try the System DSN tab 
instead. 

In the Create New Data Source window, select Microsoft Access Driver 
(*.mdb). Then click Finish. 

Clicking Finish takes you to the ODBC Microsoft Access Setup window, 
which is shown in Figure 18-3. 



Chapter 18: Using Java Database Connectivity CD~5 1 



Create New Data Source 



DropBo 



Figure 18-2: 

The Create 
New Data 
Source 
window. 
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S elect a driver for which you want to set up a data source. 
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Figure 18-3: 

The ODBC 
Microsoft 
Access 
Setup 
window. 
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6. Type a name in the Data Source Name text box and type a phrase in 
the Description text box. 

If you want to be consistent with this chapter's examples, type 
AccountDatabase in the Data Source Name text box. For the Description 
text box, you can type anything you want. (This chapter's code doesn't 
care what description you type. But for your own sake, type something 
reasonably descriptive.) 

7. Click the Create button. 

This opens up the New Database window, which is shown in Figure 18-4. 

8. Browse to the directory where you want your database file to live and 
type a filename in the Database Name text box. 

Once again, the Java code doesn't care what you do here. To keep things 
tidy, I put the file in a directory named c:\databases, but this isn't 
crucial at all. The only thing that matters is that you keep the file's . mdb 
extension. (Otherwise, your system has trouble remembering that this is 
a Microsoft Access database.) 
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Figure 18-4: 
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window. 
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9. Click OK. When you see a message box saying that the database .mdb 
file was successfully created, click OK. Back in the ODBC Microsoft 
Access Setup window, click OK. 

Finally, back in the ODBC Data Source Administrator dialog box, notice 
that your new AccountDatabase has been created (and click OK). See 
Figure 18-5. 



Figure 18-5: 

The 
Account 
Database 
has been 
created. 
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An ODBC User data source stores information about how to connect to 
the indicated data provider. A User data source is only visible to you, 
and can only be used on the current machine. 



Help 



That's great. Now you're ready to run some Java database code. 
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de that you're about to explore, the formal name is Java Database 
Connectivity (JDBC). Using JDBC, you issue database commands through Java 
code. The crux of JDBC is in two packages: ja va . sql and ja vax . sql , which 
are both in the Java API. This chapter's examples use the classes in j a v a . s q 1 . 
The first example is in Listing 18-1. 



Listing 1 8-1 : Creating a Table; Inserting Data 



import Java. sql .DriverManager; 

import j ava . sql . Statement ; 

import j ava . sql . Connecti on ; 

import j ava . sql . SQLExcepti on ; 

class CreateTable { 

public static void main(String args[]) 

throws SQLExcepti on , CI assNotFoundExcepti on { 

Class. forNa me (" sun. jdbc.odbc.JdbcOdbcDriver"); 

Connection connection = Dri verManager . getConnecti on 

( "jdbc : odbc : Ac count Data base" ) ; 
Statement statement = connecti on . createStatement( ) ; 

statement.executeUpdate( 

"create table ACCOUNTS " + 

" (NAME VARCHARC32) NOT NULL PRIMARY KEY, " + 

ADDRESS VARCHARC32) , " + 

BALANCE FLOAT) 

); 

statement.executeUpdate( 

"insert into ACCOUNTS values " + 

" ('Barry Burd', '222 Cyberspace Lane', 24.02)" 

); 

statement.executeUpdate( 

"insert into ACCOUNTS values " + 

('Jane Public', '111 Consumer Street', 55.63)" 

); 

statement . cl ose( ) ; 
connecti on . cl ose( ) ; 
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When you run the code in Listing 18-1, nothing seems to happen. The pro- 
gram starts running and then stops running. That's about it. The code has no 
tput, because all the output goes to a database. So, to see the result 
g the code in Listing 18-1, you have to look for changes in the data- 
base itself. 



If you followed the instructions in this chapter's first section and created a 
Microsoft Access database, you can use Access to examine your database. 
What you see is in Figure 18-6. 
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Usinq SQL commands 

In Listing 18-1, the heart of the code is in three calls to executelipdate. Each 
executeUpdate call contains a string — a normal, Java, double-quoted string 
of characters. To keep the code readable, I've chopped each string into parts. 
I separate the parts with plus signs (Java's string concatenation operator). 

Java's plus sign does double duty. For numbers, the plus sign performs addi- 
tion. For strings, the plus sign squishes two strings together, creating one big, 
combined string. 




You can make a double-quoted string as long as you like. When you get to the 
right edge of your screen, just keep typing. If you want to see the whole string 
without scrolling, however, you can break the string into pieces, as I did in 
Listing 18-1. Just separate the pieces with plus signs. 

You cannot break a Java string into pieces by just pressing Enter and moving 
to the next line. When you start a string with the double-quote ("), the ending 
double-quote must be on the same line of code. 



If you're familiar with SQL (the Structured Query Language), then the com- 
mand strings in the calls to executeUpdate make sense to you. If not, then 
pick up a copy of SQL For Dummies, 5th Edition, by Allen G. Taylor (from 
Wiley Publishing, Inc.). One way or another, don't go fishing around this 
chapter for explanations of create table and i nsert i nto. You won't find 
the explanations, because these command strings aren't part of Java. These 
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commands are just strings of characters that you feed to the executeUpdate 
method. These strings, which are written in SQL, create a new database table 
ows of data to the table. When you write a Java database program, 
at you do. You write ordinary SQL commands and surround those 
commands with calls to Java methods. 



The code in this chapter adheres strictly to the techniques defined in JDBC 
version 1.0. Later versions of the JDBC classes support something called 
scrollable result sets. With a scrollable result set, you have methods like 
i nsertRow — methods that save you the effort of writing complete SQL 
command strings. 



Connecting and disconnecting 

Aside from the calls to method executeUpdate, the code in Listing 18-1 is 
cut-and-paste stuff. Here's a rundown on what each part of the code means: 

Class, f orName: Find a database driver. 

To talk to a database, you need an intermediary piece of software. That 
intermediary is called a database driver. Drivers come in all shapes and 
sizes, and most of them are quite expensive. Java, however, comes with 
a small, freebie driver — the JDBC-ODBC Bridge. The JDBC-ODBC Bridge 
turns Java database commands into ODBC (Open Database Connectivity) 
commands. Because ODBC is quite common, your computer probably 
understands these translated ODBC commands. 

Anyway, the code for the JDBC-ODBC Bridge is kept in the 
JdbcOdbcDri ver class (which is a Java class). This class lives 
inside the sun.jdbc.odbc package. 

To use this JdbcOdbcDri ver class, you call the Class, f orName 
method. Believe it or not, the Java API has a class named Class. 
The Class class contains information about classes that are avail- 
able to the Java Virtual Machine (JVM). In Listing 18-1, the call to 

Class. forNa me looks for the sun. jdbc.odbc. JdbcOdbcDri ver class. 
After a JdbcOdbcDri ver instance is loaded, you can proceed to connect 
with a database. 

Dri verManager . getConnecti on: Establish a session with a particular 
database. 

If you use Windows and Microsoft Access, you may have followed the 
instructions in this chapter's first section. In following those instruc- 
tions, you told your computer about a thing called AccountDatabase. 
Well, at this point in the Java code, you're opening up a connection to 
AccountDatabase. You're doing this with the aid of the Dri verManager 
class. 
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In the parameter for getConnecti on (refer to Listing 18-1), notice the 
colons. The code doesn't simply name the AccountDatabase, it tells the 
,verManager class what protocols to use to connect with the data- 
. The code jdbc : odbc : — which is the same as the http : in a Web 
address — tells the computer to use the jdbc protocol to talk to the 
odbc protocol, which in turn talks directly to your AccountDatabase. 

i>* connecti on . createStatement: Make a statement. 

It seems strange, but in Java Database Connectivity, you create a single 
statement object. After you've created a statement object, you can use 
that object many times, with many different SQL strings, to issue many 
different commands to the database. So, before you start calling the 
statement . executeUpdate method, you have to create an actual 
statement object. The call to connecti on .createStatement creates 
that statement object for you. 

i>* SQLExcepti on and CI assNotFoundExcepti on: Acknowledge excep- 
tions that can be thrown in the code. 

If you read Chapter 12, you know that some method calls throw checked 
exceptions. A checked exception is one that has to be acknowledged 
somewhere in the calling code. Well, a call to CI ass . f orName can 
throw a CI assNotFoundExcepti on, and just about everything else in 
Listing 18-1 can throw an SQLExcepti on. To acknowledge these excep- 
tions, I top off my main method with a nice throws clause. 

cl ose: Release resources. 

As Ritter always says, you're not being considerate of others if you don't 
clean up your own messes. Every connection and every database state- 
ment lock up some system resources. When you're finished using these 
resources, you need to release them. If you don't do this by making 
explicit calls to close methods, the system has to figure out on its own 
that you're finished with these resources. Because this "figuring stuff out 
on its own" business is hit or miss, the best thing to do is to put close 
calls in your code. 



Retrieving Data 

What good is a database if you can't get data from it? In this section, you 
query the database that you created in Listing 18-1. The code to issue the 
query is in Listing 18-2. 
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Listing 18-2: Making a Query 

ilnport static Java . 1 ang . System . out ; 
1 If! |f| n flW'H j ava . sql .DriverManager; 
L-^ ■ Vy^-/ L-ZvyVyiln^? java.sql .Statement; 

import j ava . sql . Connecti on ; 
import j ava . sql . SQLExcepti on ; 
import j ava . sql . Resul tSet ; 
import j ava . text . NumberFormat ; 

class GetData { 

public static void main(String args[]) 

throws SQLExcepti on , CI assNotFoundExcepti on { 

NumberFormat currency = 

NumberFormat.getCurrencylnstanceO; 

Class. forName(" sun. jdbc.odbc.JdbcOdbcDriver"); 

Connection connection = Dri verManager . getConnecti on 

("jdbc:odbc:AccountDatabase"); 
Statement statement = connecti on . createStatement( ) ; 

ResultSet resultset = 

statement . executeQuery ( "sel ect * from ACCOUNTS"); 

whi 1 e( resul tset . next( ) ) { 

out.print(resultset. getStri ng( " NAME" ) ) ; 
out.print( "\t" ) ; 

out.print(resultset.getString( "ADDRESS" ) ) ; 
out.print( "\t" ) ; 
out . pri ntl n 

(currency . f ormat ( resultset. getFloatC BALANCE"))); 

) 

resul tset . cl ose( ) ; 
statement . cl ose( ) ; 
connecti on . cl ose( ) ; 




A run of the code from Listing 18-2 is shown in Figure 18-7. The code queries 
the database and then steps through the rows of the database, printing the 
data from each of the rows. 
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Configuration: GetData - j2sd 

2 2 Cyberspace Lane 524.02 
11 Consumer Street 555.63 



Listing 18-2 starts with the usual calls toforName,getConnection, and 
createStatement. Then the code calls executeQuery and supplies the call 
with an SQL command. For those who know SQL commands, this particular 
command gets all data from the ACCOUNTS table (the table that you create in 
Listing 18-1). 

The thing returned from calling executeQuery is of type Java . sql . Resul tSet. 
(That's the difference between executeUpdate and executeQuery — 
executeQuery returns a result set, and executeUpdate doesn't.) This result 
set is very much like a database table. Like the original table, the result set is 
divided into rows and columns. Each row contains the data for one account. 
Each row has a name, an address, and a balance amount. 

After you've called executeQuery and gotten your result set, you can step 
through the result set one row at a time. To do this, you go into a little loop 
and test the condition resul tset . next( ) at the top of each loop iteration. 
Each time around, the call to resul tset . next( ) does two things: 

i>* It moves you to the next row of the result set (the next account) if 
another row exists. 

It tells you whether or not another row exists by returning a boolean 
value — true or fa 1 se. 

If the condition resultset.nextO is true, the result set had another row. 
The computer moved to that other row, so you can march into the body of the 
loop and scoop data from that row. On the other hand, if resul tset . next( ) 
is false, the result set doesn't have any more rows. You jump out of the loop 
and start closing everything. 

Now, imagine that the computer is pointing to a row of the result set, and 
you're inside the loop in Listing 18-2. Then you're retrieving data from the 
result set's row by calling the result set's getStri ng and getFl oat methods. 
Back in Listing 18-1, you set up the ACCOUNTS table with the columns NAME, 
ADDRESS, and BALANCE. So, here in Listing 18-2, you're getting data from 
these columns by calling your getSomeTypeOrOther methods and feeding 
the original column names to these methods. After you have the data, you 
display the data on the computer screen, with a tab separating each piece of 
information. 
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For a review of the \t tab sequence, see Chapter 11. 

Resul tSet instance has several nice getSomeTypeOrOther meth- 
ods. Depending on the type of data you put into a column, you can call meth- 
ods getArray, getBigDecimal, getBlob, getlnt, getObject, 
getTimestamp, and several others. 
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